4D Doc Center : MSG

4D Internet Commands v14

MSG_Extract


MSG_Extract ( nomArchivo ; decod ; rutaDocsAdj ; listAdj ) -> resultado

Parámetro	Tipo	Descripción
nomArchivo	Texto	Nombre de archivo
decod	Entero	0 = No decodificar, 1 = Decodificar si es posible
rutaDocsAdj	Texto	Ruta de la carpeta (ruta por defecto en la carpeta attachment)
listAdj	Array cadena	Nombre de archivos adjuntos (sin ruta de acceso)
resultado	Entero	Código de error

Descripción

El comando MSG_Extract extrae todos los archivos adjuntos y los pone en la carpeta de archivos adjuntos.

nomArchivo es el nombre o la ruta de acceso completa del archivo del cual extraer los archivos adjuntos. Si sólo se da un nombre de archivo, la ruta de acceso por defecto será la de la carpeta definida por POP3_SetPrefs o MSG_SetPrefs (ver la nota de compatibilidad). Si ninguna carpeta se ha especificado, la ruta por defecto será la de la carpeta que contiene la estructura de la base de datos (con 4D monousuario) o la de la carpeta 4D Client (con 4D Server).

El parámetro decod especifica si se debe intentar decodificar el archivo adjunto. Un valor de cero indica que no se debe intentar decodificar el archivo adjunto. Un valor de 1 tratará de decodificar el archivo si se ha codificado en una de las formas siguientes: BinHex, AppleSingle, AppleDouble, o Base64.

rutaDocsAdj indica la ruta de acceso de dónde guardar el archivo adjunto. Si pasa una cadena vacía, el archivo se guardará en la carpeta de archivos adjuntos especificada por POP3_SetPrefs o MSG_SetPrefs (ver la nota de compatibilidad). Si no se especifica carpeta, el archivo adjunto se guarda en la misma carpeta que la estructura de base de datos.

Nota de compatibilidad (versión 6.8.1): si el comando MSG_SetPrefs no se utiliza, se tienen en cuenta los parámetros carpetaMsg y rutaDocsAdj del comando POP3_SetPrefs; si se utiliza MSG_SetPrefs, los parámetros carpetaMsg y rutaDocsAdj del comando POP3_SetPrefs se ignoran.

listAdj es un array alfanumérico/texto que se devuelve con los nombres de los archivos de cada archivo adjunto. Sólo el nombre del documento será devuelto en cada elemento del array, sin la ruta de acceso.