4D Internet Commands v14

POP3_MsgLst

Página Inicial

 
4D Internet Commands v14
POP3_MsgLst

POP3_MsgLst 


 

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

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.

 
PROPRIEDADES 

Produto: 4D Internet Commands
Tema: IC POP3 Review Mail
Número 88959

 
HISTÓRIA 

Criado por: 4D Internet Commands 6.5

 
VER TAMBÉM 

POP3_Charset
POP3_MsgInfo
POP3_MsgLstInfo

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v11.4)
4D Internet Commands ( 4D v13.2)
4D Internet Commands ( 4D Internet Commands v12.1)
4D Internet Commands ( 4D Internet Commands v14 R2)
4D Internet Commands ( 4D Internet Commands v14)
4D Internet Commands ( 4D Internet Commands v14 R3)
4D Internet Commands ( 4D Internet Commands v14 R4)