4D Doc Center : POP3

4D Internet Commands v14

POP3_MsgLst


POP3_MsgLst ( pop3_ID ; inicio ; fim ; arrayCabMsg ; arrayNumMsg ; arrayId ; arrayValores ) -> Resultado

Parâmetro	Tipo	Descrição
pop3_ID	Inteiro longo	Referencia de uma conexão POP3
inicio	Inteiro longo	Número da primeira mensagem
fim	Inteiro longo	Número da última mensagem
arrayCabMsg	Array cadeia	Array de cabeçalhos a recuperar
arrayNumMsg	Array inteiro longo	Array dos números de mensagens
arrayId	Array cadeia	Array alfanumérico dos ID únicos
arrayValores	2D String array, Array texto 2D	Array 2D dos valores dos cabeçalhos
Resultado	Inteiro	Código de erro

Descrição

O comando POP3_MsgLst se utiliza para obter informação específica do conteúdo das caixas de correio. arrayValores é um array de duas dimensões que recebe os dados de cada cabeçalho especificado em arrayCabMsg. Cada cabeçalho solicitado terá um array correspondente na primeira dimensão de arrayValores.

Este comando permite ao usuário solicitar colunas específicas da lista de mensagens. Este comando só devolve os valores dos cabeçalhos, não pode ser utilizado para recuperar o corpo de uma mensagem.

Nota: Os cabeçalhos de correio podem incluir caracteres estendidos, pode automatizar sua gestão utilizando o comando POP3_Charset.

Exemplo

 aHeaders{1}:="Date:"

 aHeaders{2}:="From:"

 aHeaders{3}:="Subject:"

 POP3_MsgLst(◊POP3_ID;vStart;vEnd;aHeaders;aMsgNum;aUIDs;aValues)

 aValues{1}{1}por exemplo"Quinta, 19 de novembro 1998 00:24:02 -0800"

 aValues{2}{1}por exemplo"Jack@4d.com"

 aValues{3}{1}por exemplo"Chame a sua esposa"

Os erros são tratados da seguinte forma:

1) Somente são devolvidos os códigos de erro relacionados com a comunicação. Se o comando não pode completar sua tarefa devido a um erro (da rede, a sintaxes, o servidor, etc) logo é devolvido o código de erro correspondente.

2) Se uma mensagem dentro do intervalo especificado de mensagens não existe ou contém um erro:
-- Não é criado nenhum elemento de array para essa mensagem.
-- Não é devolvido nenhum código de erro

3) A impossibilidade de localizar a um ou vários cabeçalhos em uma mensagem não constitui um erro:
-- Um elemento de array é criado para a mensagem
-- Os elementos de array "número" e "ID" contém os valores apropriados
-- Para cada cabeçalho que não se encontre na mensagem, é enviada uma cadeia vazia ao elemento de array
-- Nenhum código de erro será devolvido

Nota: Os comandos POP3_Delete, POP3_MsgLstInfo e POP3_MsgLst não devolvem um erro se a primeMsg é maior que a ultimaMsg. No caso de que isto passe, o comando não faz nada.