4D Internet Commands v14

POP3_MsgLst

Inicio

 
4D Internet Commands v14
POP3_MsgLst

POP3_MsgLst 


 

POP3_MsgLst ( pop3_ID ; inicio ; fin ; arrayEncabMsg ; arrayNumMsg ; arrayIDMsg ; arrayValores ) -> resultado 
Parámetro Tipo   Descripción
pop3_ID  Entero largo in Referencia de una conexión POP3
inicio  Entero largo in Número del primer mensaje
fin  Entero largo in Número del último mensaje
arrayEncabMsg  Array cadena in Array de encabezados a recuperar
arrayNumMsg  Array entero largo in Array de los números de mensajes
arrayIDMsg  Array cadena in Array alfanumérico de los ID únicos
arrayValores  Array 2D Cadena, Array texto 2D in Array 2D de los valores de los encabezados
resultado  Entero in Código de error

El comando POP3_MsgLst se utiliza para obtener información específica del contenido de los buzones. arrayValores es un array de dos dimensiones que recibe los datos de cada encabezado especificado en arrayEncabMsg. Cada encabezado solicitado tendrá un array correspondiente en la primera dimensión de arrayValores.

Este comando permite al usuario solicitar columnas específicas de la lista de mensajes. Este comando sólo puede devolver los valores de los encabezados, no se puede utilizar para recuperar el cuerpo de un mensaje.

Nota: los encabezados de correo pueden incluir caracteres extendidos, puede automatizar su gestión utilizando el comando POP3_Charset.

Ejemplo  

 aHeaders{1}:="Date:"
 aHeaders{2}:="From:"
 aHeaders{3}:="Subject:"
 POP3_MsgLst(◊POP3_ID;vStart;vEnd;aHeaders;aMsgNum;aUIDs;aValues)
 aValues{1}{1}por ejemplo"Jueves, 19 de noviembre 1998 00:24:02 -0800"
 aValues{2}{1}por ejemplo"Jack@4d.com"
 aValues{3}{1}por ejemplo"Llame a su esposa"

Los errores se manejan de la siguiente forma:

1) Sólo se devuelven los códigos de error relacionados con la comunicación. Si el comando no puede completar su tarea debido a un error (de la red, la sintaxis, el servidor, etc) luego se devuelve el código de error correspondiente.

2) Si un mensaje dentro del rango especificado de mensajes no existe o contiene un error:
-- No se crea ningún elemento de array para ese mensaje.
-- No se devuelve ningún código de error

3) La imposibilidad de localizar a uno o varios encabezados en un mensaje no constituye un error:
-- Un elemento de array es creado para el mensaje
-- Los elementos de array "número" e "ID" contienen los valores apropiados
-- Para cada encabezado que no se encuentre en el mensaje, se envía una cadena vacía al elemento de array
-- Ningún código de error se devolverá

Nota: los comandos POP3_Delete, POP3_MsgLstInfo y POP3_MsgLst no devuelven un error si el primerMsg es mayor que el ultimoMsg. En caso de que esto ocurra, el comando no hace nada.

 
PROPIEDADES 

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

 
HISTORIA 

Creado por: 4D Internet Commands 6.5

 
VER TAMBIÉN 

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)