4D Doc Center : FTP

4D Internet Commands v14

FTP_SetPassive


FTP_SetPassive ( ftpID ; modoPassivo ) -> Resultado

Parâmetro	Tipo	Descrição
ftpID	Inteiro longo	Referencia a uma conexão FTP
modoPassivo	Inteiro	0 = modo ativo, 1 = modo passivo (modo por padrão)
Resultado	Inteiro	Código de erro

Descrição

O comando FTP_SetPassive permite definir as modalidades de transferência de dados entre um servidor FTP e um cliente de FTP, durante o uso de comandos tais como FTP_GetDirList, FTP_Send, FTP_Append ou FTP_Receive. O modo de transferência especificado é utilizado por estes comandos uma vez seja executado o comando FTP_SetPassive.

As mudanças entre um servidor FTP e um cliente FTP tem duas partes: mudanças no canal de controle (porta 21 por padrão) e mudanças no canal de transferência de dados (porta 20 por padrão). Geralmente, os servidores FTP se definem como "ativos", como se responsabiliza da gestão da transferência no canal de dados.
Por razões históricas, 4D Internet Commands pede aos servidores FTP trabalhar em modo passivo. Isto significa que antes de cada mudança no canal de transferência de dados, seja enviado o comando FTP "PASV".
No entanto, alguns servidores FTP não suportam o modo passivo, como nem os sistemas de proteção (firewalls). Nestes casos, o comando FTP_SetPassive permite definir o modo ativo para a transferência dos dados.

Nota: É recomendado consultar com o administrador de rede o modo de transferência utilizado para as trocas FTP.

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

O parâmetro modoPassivo especifica o modo de transferência no canal de transferência de dados:

Um valor de 0, pede ao servidor FTP trabalhar em modo ativo
Um valor de 1, pede ao servidor FTP trabalhar em modo passivo (valor por padrão).