4D Doc Center : POP3

4D Internet Commands v14

POP3_GetMessage


POP3_GetMessage ( pop3_ID ; numMsg ; offset ; longitude ; textoMsg ) -> Resultado

Parâmetro	Tipo	Descrição
pop3_ID	Inteiro longo	Referencia de uma conexão POP3
numMsg	Inteiro longo	Número da mensagem
offset	Inteiro longo	Caracter a partir da qual começar a recuperação
longitude	Inteiro longo	Número de caracteres a reenviar
textoMsg	Texto	Texto da mensagem
Resultado	Inteiro	Código de erro

Descrição

O comando POP3_GetMessage devolve o texto completo da mensagem identificada por numMsg na caixa de correio referenciada por pop3_ID. A menos que seja especificado o contrário pelo comando POP3_SetPrefs, são eliminados os caracteres de salto de linha na mensagem. O comando POP3_GetMessage devolve toda mensagem, incluindo a informação de cabeçalho.

pop3_ID é uma referencia inteiro longo a uma sessão aberta criada com POP3_Login.

numMsg é um valor inteiro longo que indica qual mensagem na caixa de correio a recuperar. numMsg representa a posição de uma mensagem dentro da lista atual de mensagens. O numMsg de uma mensagem não é um valor estável, difere de uma sessão a outra em função das eliminações.

offset é um valor inteiro longo que indica a posição do caracter a partir do qual começar a leitura. Na maioria dos casos passe zero neste parâmetro.

O parâmetro longitude é um valor inteiro longo que indica o número de caracteres a recuperar além da posição offset. Dado que a longitude máxima deste parâmetro está limitada a 32.000 caracteres por razões históricas, o parâmetro longitude deve ser inferior a 32.000. As mensagens cujo tamanho seja maior que 32 K deve ser recuperado no disco utilizando o comando POP3_Download.

textoMsg é uma variável texto que recebe o texto recuperado.