4D Doc Center : IMAP

4D Internet Commands v14

IMAP_SetCurrentMB


IMAP_SetCurrentMB ( imap_ID ; nomBuzon ; numMsg ; numNuevMsg ; listMarc ; marcPermanent ; unicoIDB ) -> resultado

Parámetro	Tipo	Descripción
imap_ID	Entero largo	Referencia de conexión IMAP
nomBuzon	Texto	Nombre del buzón a seleccionar
numMsg	Entero largo	Número de mensajes en el buzón especificado
numNuevMsg	Entero largo	Número de mensajes con el marcador \Recent
listMarc	Texto	Lista de marcadores utilizados actualmente por el buzón
marcPermanent	Texto	Lista de marcadores modificables
unicoIDB	Entero largo	Número de identificación único del buzón especificado
resultado	Entero	Código de error

Descripción

El comando IMAP_SetCurrentMB permite abrir una sesión (es decir, seleccionar el buzón actual) para administrar los mensajes del buzón especificado.

Una sola sesión puede abrirse a la vez durante una conexión, el acceso simultáneo a varios buzones requiere múltiples conexiones (múltiples IMAP_Login). El comando IMAP_SetCurrentMB cierra automáticamente la sesión actual antes de realizar la nueva selección. Por lo tanto, si se define un buzón como actual y la ejecución del comando IMAP_SetCurrentMB falla, no habrá buzón actual.

Puede cerrar una sesión, (es decir, cerrar el buzón actual) sin seleccionar uno nuevo, ejecutando el comando IMAP_SetCurrentMB con un nomBuzon inexistente y durante la gestión de errores, ejecutando IMAP_CloseCurrentMB o IMAP_Logout.

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

nomBuzon es el nombre completo de un buzón a definir como buzón actual.

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

listMarc devuelve la lista completa de marcadores utilizados en el buzón actual. Tenga en cuenta que sólo los marcadores listados en el parámetro marcPermanent pueden modificarse.

marcPermanent devuelve la lista de marcadores que pueden modificarse de forma permanente (con excepción del marcador \Recent, que es administrado por el servidor IMAP). Note que la cadena marcPermanent también puede incluir el marcador especial \*, lo que significa que las palabras claves pueden crearse guardando los marcadores en el buzón (ver IMAP_SetFlags).

Si permanentFlags devuelve una cadena vacía, esto significa que todos los marcadores listados en el parámetro listMarc se pueden modificar.

unicoIDB devuelve un identificador único del buzón actual.
Este identificador puede ser particularmente útil si se elimina un buzón y un nuevo buzón con el mismo nombre se crea en una fecha posterior. Dado que el nombre es el mismo, sólo el número único permite al cliente identificar el nuevo buzón.