4D Doc Center : IMAP

4D Internet Commands v14

IMAP_CopyToMB


IMAP_CopyToMB ( imap_ID ; primerMsg ; ultimoMsg ; nomBuzonObjetivo ; borrarMsg ) -> 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
nomBuzonObjetivo	Texto	Nombre del buzón de destino
borrarMsg	Entero	0= No eliminar del buzón fuente, 1= Eliminar del buzón fuente
resultado	Entero	Código de error

Descripción

El comando IMAP_CopyToMB copia los mensajes en el intervalo de primerMsg a ultimoMsg al final del buzón de destino nomBuzonObjetivo. Los marcadores y fechas internas de los mensajes por lo general se conservan en el buzón de destino, en función de la implementación del servidor IMAP.

Después de la copia, los mensajes originales no se eliminan del buzón fuente. Si desea eliminarlos, puede utilizar uno de los siguientes tres procesos:

Utilizar el comando IMAP_Delete,
Pasar el valor 1 en el parámetro opcional borrarMsg,
ubicar el marcador IMAP_SetFlags (\Deleted): los mensajes se eliminan cuando se cierra la sesión.

Nota: el parámetro borrarMsg obliga la ejecución de IMAP_Delete; por lo tanto, la eliminación incluirá los mensajes entre primerMsg y ultimoMsg y TODOS los mensajes con el marcador \Deleted.

Si el buzón de destino no existe, se devuelve un error.

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 copiar. 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 imap_ID.

ultimoMsg es un número entero largo que indica el número del último mensaje a copiar. 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 imap_ID.

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 ultimoMsg. En caso de que esto ocurra, el comando no hace nada.

nomBuzonObjetivo es el nombre completo del buzón donde se van a copiar los mensajes.

El parámetro opcional borrarMsg permite indicar si desea eliminar el mensaje del buzón de origen.
• 0= No eliminar los mensajes (valor por defecto);
• 1= Borrar los mensajes.

Si se omite borrarMsg se utiliza el valor por defecto.

Si la copia falla, el mensaje no se elimina del buzón de origen.

Si el usuario no tiene derechos de acceso suficientes para eliminar los mensajes, se genera un mensaje de error.