4D Doc Center : IMAP

4D Internet Commands v14

IMAP_MsgLstInfo


IMAP_MsgLstInfo ( imap_ID ; primerMsg ; ultimoMsg ; arrayTamMsg ; arrayNumMsg ; arrayIDMsg ) -> resultado

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

Descripción

El comando IMAP_MsgLstInfo devuelve información sobre un conjunto de mensajes en el buzón actual (definido por el comando IMAP_SetCurrentMB). 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 y el número del mensaje. Los arrays pasados como parámetros deben ser declarados previamente, aunque pueden ser de cualquier tamaño. El comando IMAP_MsgLstInfo redimensiona cada array al número de mensajes recuperados.

El comando IMAP_MsgLstInfo no devuelve un número de error si no puede recuperar la información en un mensaje dentro de la lista de mensajes actual. Si se produce un error, no se crea ningún elemento en los arrays para el mensaje de 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.

imap_ID es una referencia entero largo a una conexión abierta creada con IMAP_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 de trabajo actual.

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 de trabajo actual.

Nota: los comandos IMAP_Delete, IMAP_MsgLstInfo, IMAP_MsgLst, IMAP_SetFlags, IMAP_GetFlags y IMAP_CopyToMB no devuelven un error si primerMsg es mayor que el ultimoMsg. En caso de que esto ocurra, el comando no hace nada.

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

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

arrayValoresMsg recibe los identificadores únicos de los mensajes entre primerMsg y ultimoMsg.