4D Internet Commands v14

IMAP_Download

Inicio

 
4D Internet Commands v14
IMAP_Download

IMAP_Download 


 

IMAP_Download ( imap_ID ; numMsg ; encabSolo ; nomArchivo ; actSeen ) -> resultado 
Parámetro Tipo   Descripción
imap_ID  Entero largo in Referencia de conexión IMAP
numMsg  Entero largo in Número del mensaje
encabSolo  Entero in 0 = Mensaje entero, 1 = Encabezado únicamente
nomArchivo  Texto in Nombre del archivo local
in Nombre del archivo local utilizado
actSeen  Entero in 0 = Añadir marcador \Seen; 1= No añadir el marcador \Seen
resultado  Entero in Código de error

El comando IMAP_Download está diseñado para recuperar un mensaje de un servidor IMAP, grabándolo en el disco local. Todo mensaje IMAP que contiene archivos adjuntos o cuyo tamaño es mayor a 32 K debe ser descargado con este comando. Los archivos adjuntos sólo pueden extraerse de los mensajes recuperados de esta manera.

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

numMsg es un valor entero largo que indica cual mensaje en el buzón recuperar. numMsg representa la posición de un mensaje dentro de la lista actual de mensajes. El numMsg de un mensaje no es un valor estable, difiere de una sesión a otra.

encabSolo es un valor entero que indica si se debe recuperar todo el mensaje o sólo la información del encabezado.

nomArchivo contiene el nombre del archivo y la ruta de acceso opcional donde desea guardar el mensaje. Este valor se puede especificar de tres formas diferentes:

  • "" = Guarda el archivo en la carpeta definida por IMAP_SetPrefs, con el nombre "temp1" (si un archivo con el mismo nombre ya existe, los nombres de archivo "temp2", "temp3", etc. se utilizarán hasta que se encuentre un nombre de archivo sin utilizar).
  • "NomArchivo" = Guarda el archivo en la carpeta definida por IMAP_SetPrefs con el nombre nomArchivo.
  • "Ruta:nomArchivo" = Guarda el archivo en la ruta especificada con el nombre nomArchivo.

En los dos primeros casos, si IMAP_SetPrefs, no especifica ninguna carpeta, el mensaje se guardará en la misma carpeta que la estructura de la base de datos (con 4D monopuesto) o en la carpeta 4D Client (con 4D Server).

Después de que el archivo se guarde en el disco, el nombre final del archivo se devuelve en el parámetro nomArchivo. Si intenta llamar a IMAP_Download  con un nombre de archivo que ya existe dentro de la carpeta de descarga, el nombre se incrementa numéricamente  y su nuevo valor como se guarda en el disco será devuelto a la variable nomArchivo.

actSeen es un valor entero que indica si el  marcador \Seen se debe agregar a la lista de marcadores del mensaje. Este parámetro es opcional y se utiliza un valor por defecto si no se pasa este parámetro:

  • 0 = Añadir el marcador \Seen
  • 1 = No añadir el marcador \Seen

El valor por defecto es 0 lo que significa implícitamente, añadir el marcador \Seen.

 
PROPIEDADES 

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

 
HISTORIA 

Creado por: 4D Internet Commands 6.8.1

 
VER TAMBIÉN 

IMAP_GetMessage
IMAP_SetPrefs

 
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)