4D Doc Center : FTP

4D Internet Commands v14

FTP_SetPassive


FTP_SetPassive ( ftp_ID ; modePassif ) -> Résultat

Paramètre	Type	Description
ftp_ID	Entier long	Référence d'une connexion FTP
modePassif	Entier	0 = mode actif, 1 = mode passif (mode par défaut)
Résultat	Entier	Code d'erreur

Description

La commande FTP_SetPassive permet de définir les modalités d'échange sur le canal de transfert des données entre un serveur et un client FTP, lors de l'utilisation des commandes telles que FTP_GetDirList, FTP_Send, FTP_Append et FTP_Receive. Le mode de transfert spécifié est utilisé par ces commandes dès que vous avez exécuté FTP_SetPassive.

Les échanges entre un serveur et un client FTP se décomposent en deux parties : échanges sur le canal de contrôle (port 21 par défaut) et échanges sur le canal de transfert de données (port 20 par défaut).
Généralement, les serveurs FTP sont dits “actifs”, car ils prennent en charge la gestion du transfert sur le canal de données et se connectent au client FTP.
Pour des raisons historiques, les commandes Internet de 4D demandent aux serveurs FTP de fonctionner en mode passif, ce qui consiste notamment à exécuter systématiquement la commande FTP “PASV” avant chaque échange sur le canal de transfert de données.
Toutefois, certains serveurs FTP ne permettent pas l'emploi du mode passif. En outre, ce mode peut être interdit par les systèmes de protection (firewall) des sites. Dans ce cas, la commande FTP_SetPassive vous permet de définir le mode actif pour le transfert des données.

Note : Il est recommandé de vérifier avec l'administrateur réseau le mode de transfert préconisé sur le site.

ftp_ID est l'identifiant de la session FTP établie avec FTP_Login.

Le paramètre modePassif permet de préciser le mode de transfert sur le canal de transfert des données :

Si vous passez 0, vous demandez au serveur FTP de fonctionner en mode actif.
Si vous passez 1, vous demandez au serveur FTP de fonctionner en mode passif (valeur par défaut).