4D Doc Center : POP3

4D Internet Commands v14

POP3_DownLoad


POP3_DownLoad ( pop3_ID ; numMsg ; encabSolo ; nomArchivo ) -> resultado

Parámetro	Tipo	Descripción
pop3_ID	Entero largo	Referencia de una conexión POP3
numMsg	Entero largo	Número del mensaje
encabSolo	Entero	0 = Mensaje entero, 1 = Encabezado únicamente
nomArchivo	Texto	Nombre del archivo local
		Nombre del archivo local utilizado
resultado	Entero	Código de error

Descripción

El comando POP3_DownLoad está diseñado para recuperar un mensaje de un servidor POP3 mediante la descarga en un archivo en disco. Todo mensaje POP3 que contenga archivos adjuntos o cuyo tamaño es mayor que 32K debe ser descargado con este comando. Los archivos adjuntos sólo pueden extraerse de los mensajes recuperados de esta manera.

pop3_ID es una referencia entero largo a una sesión abierta creada con POP3_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 en función de la eliminaciones.

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 maneras diferentes:

""	= Guarda el archivo en la carpeta definida por POP3_SetPrefs, con el nombre "temp1" (si un archivo con el mismo nombre ya existe, se prueba con los nombres "temp2", "temp3", etc.)
"nomArchivo"	= Guarda el archivo en la carpeta definida por POP3_SetPrefs, con el nombre nomArchivo
"Ruta:nomArchivo"	= Guarda el archivo en la ruta especificada por nomArchivo

En los dos primeros casos, si POP3_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 POP3_Download con un nomArchivo que ya existe en 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.