4D Doc Center : POP3

4D Internet Commands v14

POP3_MsgLst


POP3_MsgLst ( pop3_ID ; inicio ; fin ; arrayEncabMsg ; arrayNumMsg ; arrayIDMsg ; arrayValores ) -> resultado

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

Descripción

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.