4D Internet Commands v14

FTP_MacBinary

Página Inicial

 
4D Internet Commands v14
FTP_MacBinary

FTP_MacBinary 


 

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

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

 
PROPRIEDADES 

Produto: 4D Internet Commands
Tema: IC File Transfer
Número 88938

 
HISTÓRIA 

Criado por: 4D Internet Commands 6.5

 
VER TAMBÉM 

IT_Decode

 
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)