4D Internet Commands v14

IMAP_CopyToMB

Inicio

 
4D Internet Commands v14
IMAP_CopyToMB

IMAP_CopyToMB 


 

IMAP_CopyToMB ( imap_ID ; primerMsg ; ultimoMsg ; nomBuzonObjetivo ; borrarMsg ) -> resultado 
Parámetro Tipo   Descripción
imap_ID  Entero largo in Referencia de conexión IMAP
primerMsg  Entero largo in Número del primer mensaje
ultimoMsg  Entero largo in Número del último mensaje
nomBuzonObjetivo  Texto in Nombre del buzón de destino
borrarMsg  Entero in 0= No eliminar del buzón fuente, 1= Eliminar del buzón fuente
resultado  Entero in Código de error

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.

 
PROPIEDADES 

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

 
HISTORIA 

Creado por: 4D Internet Commands 6.8.1

 
VER TAMBIÉN 

IMAP_CreateMB
IMAP_ListMBs
IMAP_RenameMB

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v11.4)
4D Internet Commands ( 4D v13.2)
4D Internet Commands ( 4D Internet Commands v12.1)
4D Internet Commands ( 4D Internet Commands v14 R2)
4D Internet Commands ( 4D Internet Commands v14)
4D Internet Commands ( 4D Internet Commands v14 R3)
4D Internet Commands ( 4D Internet Commands v14 R4)