4D Doc Center : IMAP

4D Internet Commands v14

IMAP_Delete


IMAP_Delete ( imap_ID ; primeMsg ; ultimaMsg ) -> Resultado

Parâmetro	Tipo	Descrição
imap_ID	Inteiro longo	Referencia de conexão IMAP
primeMsg	Inteiro longo	Número da primeira mensagem
ultimaMsg	Inteiro longo	Número da última mensagem
Resultado	Inteiro	Código de erro

Descrição

O comando IMAP_Delete localiza o marcador \Deleted em cada mensagem do intervalo compreendido entre primeMsg e ultimaMsg, depois apaga todas as mensagens que tem este marcador (inclusive as mensagens nas quais o marcador \Deleted tenha sido fixado previamente para a sessão atual). A eliminação é realizada pelo servidor IMAP e é levada a cabo quando se fecha a conexão (IMAP_Logout) ou ao selecionar outra caixa de correio atual (IMAP_SetCurrentMB) ou ao fechar a caixa de correio atual (IMAP_CloseCurrentMB).

Se não deseja que a eliminação seja imediata, pode utilizar o comando IMAP_SetFlags e configurar o marcador \Deleted para apagar as mensagens depois.

imap_ID é uma referencia inteiro longo a uma conexão aberta criada com IMAP_Login.

O parâmetro primeMsg é o número da primeira mensagem a eliminar.

O parâmetro ultimaMsg é o número da última mensagem a eliminar.

Nota: Os comandos IMAP_Delete, IMAP_MsgLstInfo, IMAP_MsgLst, IMAP_SetFlags, IMAP_GetFlags e IMAP_CopyToMB não devolvem um erro se primeMsg é maior que ultimaMsg. No caso de que isto passe, o comando não faz nada.