4D Doc Center : POP3

4D Internet Commands v14

POP3_MsgLstInfo


POP3_MsgLstInfo ( pop3_ID ; primeMsg ; ultimaMsg ; arrayTam ; arrayNumMsg ; arrayId ) -> Resultado

Parâmetro	Tipo	Descrição
pop3_ID	Inteiro longo	Referencia de uma conexão POP3
primeMsg	Inteiro longo	Número da primeira mensagem
ultimaMsg	Inteiro longo	Número da última mensagem
arrayTam	Array inteiro longo	Array dos tamanhos
arrayNumMsg	Array inteiro longo	Array dos números de mensagens
arrayId	Array cadeia	Array dos ID únicos
Resultado	Inteiro	Código de erro

Descrição

O comando POP3_MsgLstInfo devolve informação sobre um conjunto de mensagens em uma caixa de correio. A informação é devolvida em três arrays, cada elemento dos arrays corresponde a uma mensagem. É devolvida a informação sobre o tamanho de cada mensagem, o número de mensagem e o ID único da mensagem. Os arrays passados como parâmetros devem ser declarados, ainda que podem ser de qualquer tamanho. O comando POP3_MsgLstInfo redimensiona cada array ao número de mensagens recuperadas.

O comando POP3_MsgLstInfo não devolverá um número de erro se não pode recuperar a informação sobre uma mensagem dentro da lista de mensagens atual. É detectado um erro, não é criado nenhum elemento nos arrays para a mensagem do problema. Se o comando lê todos as mensagens com sucesso, arrayNumMsg deve conter valores numéricos em uma ordem sequencial. Em caso de problemas, será perdida a sequencia numérica de arrayNumMsg.

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

primeMsg é um número inteiro longo que especifica o número da primeira mensagem a examinar. O número de mensagem é um valor que representa a posição de uma mensagem na lista de todos as mensagens na caixa de correio identificada por pop3_ID.

ultimaMsg é um número inteiro longo que indica o número da última mensagem a examinar. O número de mensagem é um valor que representa a posição de uma mensagem na lista de todas as mensagens na caixa de correio identificada por pop3_ID.

arrayTam recebe o tamanho de cada mensagem entre primeMsg e ultimaMsg.

arrayNumMsg devolve os números das mensagens entre primeMsg e ultimaMsg.

arrayId é um array cadeia ou texto devolvido, contém o identificador único das mensagens entre primeMsg e ultimaMsg .

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