4D Internet Commands v16

FTP_Send

Página Inicial

 
4D Internet Commands v16
FTP_Send

FTP_Send 


 

FTP_Send ( ftp_ID ; viaLocal ; viaServidor ; progresso ) -> Resultado 
Parâmetro Tipo   Descrição
ftp_ID  Inteiro longo in Referencia de uma conexão FTP
viaLocal  Texto in Via de acesso local do documento a enviar
viaServidor  Texto in Via de acesso do documento no servidor FTP
progresso  Inteiro in 1 = Mostrar progresso, 0 = Ocultar progresso
Resultado  Inteiro in Código de erro

O comando FTP_Send envia o documento designado por viaLocal à localização designada por viaServidor. É produzido um erro de estado de arquivo FTP, FTP_Send é devolvido imediatamente.

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

viaLocal é a via do documento a enviar. Se passada uma cadeia vazia, aparece a caixa de diálogo padrão de abertura de arquivos. Se viaLocal é um nome de arquivo simples (sem via de acesso), o comando busca este arquivo na pasta que contém o arquivo de estrutura do banco de dados (com 4D autônomo) ou na pasta de 4D Client (com 4D Server). Ao igual que com todas as vias de acesso a documentos locais, os diretórios devem estar separados por um delimitador apropriado para a plataforma. Para obter mais informação, consulte a seção Glossário e terminologia.

Nota: os comandos FTP trabalham com documentos cujos nomes tem uma amplitude limitada. Para obter mais informação, consulte a seção Transferência de arquivos, Apresentação .

viaServidor designa a via de acesso ao formato Unix do documento a criar. viaServidor indica o novo nome do arquivo uma vez recebido pelo servidor FTP. Se viaLocal é uma cadeia vazia que permite ao usuário escolher um arquivo do disco, viaServidor também pode ser uma cadeia vazia, em cujo caso se utilizará o nome do arquivo selecionado.

viaServidor pode ser uma via de acesso Unix completa ou simplesmente um nome de arquivo:

  • Se passar uma via de acesso completa, o arquivo especificado será localizado no diretório indicado por viaServidor.
  • Se somente passa um nome de arquivo, ou cadeias vazias na seleção do arquivo, o arquivo será enviado ao diretório de trabalho atual [CWD].

Se o arquivo ou a via não podem ser interpretados corretamente, o comando devolverá um erro. Se o usuário não tem os privilégios suficientes para enviar um arquivo a esse diretório, é devolvido um erro. Ao igual que com todas as vias de acesso aos documentos Unix, a via deve utilizar barras oblíquas como separadores ("/"). Para mais informação, consulte a seção Glossário e terminologia.

Nota: o servidor FTP também pode impor limitações específicas relativas a amplitude ou caracteres para os nomes de arquivo.

O parâmetro progresso indica se o termômetro de progresso. Passe 1 para mostrar termômetro de progresso ou 0 para ocultar.

 $OK:=False
 Case of
    :(FTP_Login("ftp.4d.com";"anonymous";vEmailID;vFTP_ID;vFTP_Msg)#0)
    :(FTP_Progress(-1;-1;"Progress window";"Getting requested file…";"Cancel")#0)
    :(FTP_Send(vFTP_ID;"My Hard Drive:Documents:July Sales Report";"/pub/reports/July_sales";1)#0)
    :(FTP_Logout(vFTP_ID)#0)
    Else
       $OK:=True `todos os comandos são executados sem erro
 End case

Nota: para maior informação sobre este uso particular da estrutura Case of, consulte o Apêndice A, Dicas de programaçãoPOP3_MsgLstInfo.

 $error:=FTP_Send(vFTP_ID;"";"";1)



Ver também 

FTP_Progress
FTP_Receive

 
PROPRIEDADES 

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

 
HISTÓRIA 

Criado por: 4D Internet Commands 6.5

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v16)