4D Doc Center : IMAP

4D Internet Commands v14

IMAP_GetMBStatus


IMAP_GetMBStatus ( imap_ID ; nomBuzon ; numMsg ; numNuevMsg ; numMsgNoLeido ; unicoIDB ) -> resultado

Parámetro	Tipo	Descripción
imap_ID	Entero largo	Referencia de conexión IMAP
nomBuzon	Texto	Nombre del buzón
numMsg	Entero largo	Número de mensajes en el buzón especificado
numNuevMsg	Entero largo	Número de mensajes con el marcador \Recent
numMsgNoLeido	Entero largo	Número de mensajes sin el marcador \Seen
unicoIDB	Entero largo	Número de identificación único del buzón especificado
resultado	Entero	Código de error

Descripción

El comando IMAP_GetMBStatus devuelve el estado de los parámetros del buzón especificado por nomBuzon. No cambia el buzón actual (ver IMAP_SetCurrentMB), ni afecta el estado de los mensajes en el buzón especificado (en particular, por lo general no borra los marcadores \Recent, pero esto puede variar en función de los parámetros del servidor IMAP4). Este comando alternativo permite obtener el estado de los parámetros sin desactivar el buzón actual.

Este comando es particularmente útil para:

Verificar o recuperar el número de identificación único de un buzón,
Verificar los mensajes recientes o no leídos de un buzón sin abrir una sesión especifica.

Importante: le recomendamos no llamar el comando IMAP_GetMBStatus utilizando el buzón actual. De esta manera, puede encontrar problemas y la información devuelta puede no estar sincronizada con el estado del buzón actual (en particular para los nuevos e-mails).

imap_ID es una referencia entero largo a una conexión abierta creada con IMAP_Login.

nomBuzon es el nombre completo del buzón existente para el que desea obtener los parámetros de estado.

Nota: a diferencia del comando IMAP_ListMBs, el parámetro nomBuzon no acepta comodines.

numMsg devuelve el número de mensajes en el buzón actual (devuelve -1 en caso de error).

numNuevMsg devuelve el número de mensajes recientes en el buzón actual (devuelve -1 en caso de error).

numMsgNoLeido devuelve el número de mensajes no leídos en el buzón actual (devuelve -1 en caso de error)

unicoIDB devuelve el número de identificación único del buzón (devuelve -1 en caso de error).

Con el protocolo IMAP4, el nombre del buzón no es suficiente para identificar a un buzón. Por lo tanto, un identificador único valor se asocia a cada buzón. Este identificador es particularmente valioso para la sincronización de tareas.
De esta forma, puede comprobar si el buzón "A" ha sido renombrado como "B" o eliminado, simplemente verificando su número de identificación único.
Por otra parte, este identificador permite comprobar si un buzón llamado "A" se ha eliminado y si se ha creado otro buzón "A".