FTP_MacBinary

4D Internet Commands v16

FTP_MacBinary


FTP_MacBinary ( ftp_ID ; modoMacBinary ) -> resultado

Parámetro	Tipo	Descripción
ftp_ID	Entero largo	Referencia de una conexión FTP
modoMacBinary	Entero	-1 = Obtener el parámetro actual, 1 = Activar, 0 = Desactivar
		Parámetro actual (si se pasa -1)
resultado	Entero	Código de error

Descripción

El comando FTP_MacBinary activa/desactiva el modo MacBinary para las transferencias FTP utilizando FTP_Send y FTP_Receive en la sesión FTP actual identificada por ftp_ID.

El protocolo MacBinary es utilizado con frecuencia por clientes y servidores FTP Macintosh para facilitar la transferencia de datos o de archivos binarios que contienen a la vez partes de datos (data forks) y parte de recursos (resource fork).

Nota para usuarios Windows: es posible usar el protocolo MacBinary para las transferencias FTP en un entorno Windows sin embargo cabe señalar que a menudo no tiene sentido decodificar un archivo MacBinary en un ordenador PC. Los ordenadores con procesadores Intel no pueden almacenar archivos con data forks y resource forks. Como este formato es ajeno a la plataforma Windows, los archivos Mac OS que contienen una parte de recursos (resource fork) corren el riesgo de dañarse si se guardan en un formato no codificado.

ftp_ID es la referencia entero largo de la sesión FTP establecida con FTP_Login.

El parámetro modoMacBinary indica si se debe activar o no el modo de transferencia MacBinary. Este valor debe pasarse como una variable para que el comando pueda devolver el estado de las transferencias MacBinary después del intento de cambio. 1 activa el modo de transferencia MacBinary y cero lo desactiva. -1 devuelve en modoMacBinary el parámetro actual del modo de transferencia MacBinary (1 ó 0).

Atención: no todos los servidores FTP soportan el protocolo MacBinary, en este caso el error 10053 se devuelve en cada llamada al comando FTP_MacBinary, cualquiera que sea el valor del parámetro modoMacBinary. Los comportamientos descritos previamente no aplican más.

Ejemplo

Este ejemplo activa el protocolo MacBinary antes de la recepción de un archivo FTP. Si el archivo se recibe correctamente con el MacBinary activado, se decodifica en su formato original y se borra el documento MacBinary.

 vUseMacBin:=-1

 $error:=FTP_MacBinary(vFTP_ID;vUseMacBin)

 If($error=10053)

    MacBinaryIsSupported:=False `El servidor ftp no soporta el protocolo MacBinary

 Else

    MacBinaryIsSupported:=True

 End if

 

 

 vLocalFile:=""

 If(MacBinaryIsSupported)

    vUseMacBin:=1

    $error:=FTP_MacBinary(vFTP_ID;vUseMacBin) `Activación de MacBinary para la descarga

 End if

 $error:=FTP_Receive(vFTP_ID;"MyApplication";vLocalFile;cbShowTherm)

 If($error=0) & (vUseMacBin=1) `Si recibe OK y el archivo está en formato MacBinary

    vDecodePath:=""

    If(IT_Decode(vLocalFile;vDecodePath;8)=0) `Decodificación MacBinary

       DELETE DOCUMENT(vLocalFile) `Si se decodifica la fuente con éxito, se borra el archivo fuente.

    End if

 End if

Ver también

IT_Decode