4D Internet Commands v16

IMAP_GetMBStatus

Inicio

 
4D Internet Commands v16
IMAP_GetMBStatus

IMAP_GetMBStatus 


 

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

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".



Ver también 

IMAP_GetFlags
IMAP_ListMBs
IMAP_SetCurrentMB
IMAP_SetFlags

 
PROPIEDADES 

Producto: 4D Internet Commands
Tema: IC IMAP Review Mail
Número 88879

 
HISTORIA 

Creado por: 4D Internet Commands 6.8.1

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v16)