FTP_MacBinary

4D Internet Commands v16

FTP_MacBinary


FTP_MacBinary ( ftp_ID ; modoMacBinary ) -> Resultado

Parâmetro	Tipo	Descrição
ftp_ID	Inteiro longo	Referencia de uma conexão FTP
modoMacBinary	Inteiro	-1 = Obter o parâmetro atual, 1 = Ativar, 0 = Desativar
		Parâmetro atual (se passado -1)
Resultado	Inteiro	Código de erro

Descrição

O comando FTP_MacBinary ativa/desativa o modo MacBinary para as transferências FTP utilizando FTP_Send e FTP_Receive na sessão FTP atual identificada por ftp_ID.

O protocolo MacBinary é usado com frequência por clientes e servidores FTP Macintosh para facilitar a transferência de dados ou de arquivos binários que contém ao mesmo tempo partes de dados (data forks) e parte de recursos (resource fork).

Nota para usuários Windows: É possível usar o protocolo MacBinary para as transferências FTP em um ambiente Windows no entanto cabe assinalar que com frequência não tem sentido decodificar um arquivo MacBinary em um computador PC. Os computadores com processadores Intel não podem armazenar arquivos com data forks e resource forks. Como este formato é estranho à plataforma Windows, os arquivos Mac OS que contém uma parte de recursos (resource fork) passam o risco de ser danificados se guardados em um formato não codificado.

ftp_ID é a referencia inteiro longo da sessão FTP estabelecida com FTP_Login.

O parâmetro modoMacBinary indica se deve ser ativada ou não o modo de transferência MacBinary. Este valor deve ser passado como uma variável para que o comando possa devolver o estado das transferências MacBinary depois da tentativa de mudança. 1 ativa o modo de transferência MacBinary e zero desativa. -1 devolve em modoMacBinary o parâmetro atual do modo de transferência MacBinary (1 ou 0).

Atenção: Não todos os servidores FTP suportam o protocolo MacBinary, neste caso o erro 10053 é devolvido em cada chamada ao comando FTP_MacBinary, qualquer que seja o valor do parâmetro modoMacBinary. Os comportamentos descritos previamente não são mais aplicados.

Exemplo

Este exemplo ativa o protocolo MacBinary antes da recepção de um arquivo FTP. Se o arquivo se recebe corretamente com o MacBinary ativado, se decodifica em seu formato original e se apaga o documento MacBinary.

 vUseMacBin:=-1

 $error:=FTP_MacBinary(vFTP_ID;vUseMacBin)

 If($error=10053)

    MacBinaryIsSupported:=False `O servidor ftp não suporta o protocolo MacBinary

 Else

    MacBinaryIsSupported:=True

 End if

 

 

 vLocalFile:=""

 If(MacBinaryIsSupported)

    vUseMacBin:=1

    $error:=FTP_MacBinary(vFTP_ID;vUseMacBin) `Ativação de MacBinary para o download

 End if

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

 If($error=0) & (vUseMacBin=1) `Se recebe OK e o arquivo está em formato MacBinary

    vDecodePath:=""

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

       DELETE DOCUMENT(vLocalFile) `Se é decodificada a fonte com sucesso, é apagado o arquivo fonte.

    End if

 End if

Ver também

IT_Decode