FTP_SetPassive

4D - Documentation   Français   English   German   Commandes Internet de 4D, Sommaire   Commandes Internet de 4D, Index   Retour   Précédent   Suivant

version 6.5.3 (Modifiée)


FTP_SetPassive (ftp_ID; modePassif) Entier

ParamètreTypeDescription
ftp_IDEntier longRéférence d'une connexion FTP
modePassifEntier0 = mode actif, 1 = mode passif (mode par défaut)
RésultatEntierCode 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).

Référence

FTP_GetPassive.


4D - Documentation   Français   English   German   Commandes Internet de 4D, Sommaire   Commandes Internet de 4D, Index   Retour   Précédent   Suivant