4D Doc Center : POP3

4D Internet Commands v14

POP3_MsgLstInfo


POP3_MsgLstInfo ( pop3_ID ; primerMsg ; ultimoMsg ; arrayTam ; arrayNumMsg ; arrayIDMsg ) -> resultado

Parámetro	Tipo	Descripción
pop3_ID	Entero largo	Referencia de una conexión POP3
primerMsg	Entero largo	Número del primer mensaje
ultimoMsg	Entero largo	Número del último mensaje
arrayTam	Array entero largo	Array de los tamaños
arrayNumMsg	Array entero largo	Array de los números de mensajes
arrayIDMsg	Array cadena	Array de los ID únicos
resultado	Entero	Código de error

Descripción

El comando POP3_MsgLstInfo devuelve información sobre un conjunto de mensajes en un buzón. La información se devuelve en tres arrays, cada elemento de los arrays corresponde a un mensaje. Se devuelve información sobre el tamaño de cada mensaje, el número de mensaje y el ID único del mensaje. Los arrays pasados como parámetros deben ser declarados, aunque pueden ser de cualquier tamaño. El comando POP3_MsgLstInfo redimensiona cada array al número de mensajes recuperados.

El comando POP3_MsgLstInfo no devolverá un número de error si no puede recuperar la información sobre un mensaje dentro de la lista de mensajes actual. Si se detecta un error, no se crea ningún elemento en los arrays para el mensaje del problema. Si el comando lee todos los mensajes con éxito, arrayNumMsg debe contener valores numéricos en un orden secuencial. En caso de problemas, se perderá la secuencia numérica de arrayNumMsg.

pop3_ID es una referencia entero largo a una sesión abierta creada con POP3_Login.

primerMsg es un número entero largo que especifica el número del primer mensaje a examinar. El número de mensaje es un valor que representa la posición de un mensaje en la lista de todos los mensajes en el buzón identificado por pop3_ID.

ultimoMsg es un número entero largo que indica el número del último mensaje a examinar. El número de mensaje es un valor que representa la posición de un mensaje en la lista de todos los mensajes en el buzón identificado por pop3_ID.

arrayTam recibe el tamaño de cada mensaje entre primerMsg y ultimoMsg.

arrayNumMsg devuelve los números de los mensajes entre primerMsg y ultimoMsg.

arrayIDMsg es un array cadena o texto devuelto contiene el identificador único de los mensajes entre primerMsg y ultimoMsg .

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.