|
|
|
|
|
FTPConnecte (Fonction) En anglais : FTPConnect Connecte le poste en cours à un serveur FTP (File Transfer Protocol). // Connexion du poste en cours au serveur FTP ResConnecte = FTPConnecte("192.54.12.8") Syntaxe
<Résultat> = FTPConnecte(<Serveur> [, <Nom de l'utilisateur> [, <Mot de passe> [, <Numéro de port> [, <Type de connexion> [, <Délai de connexion> [, <Clé privée> [, <Mot de passe de la clé>]]]]]]])
<Résultat> : Entier - Identifiant de la connexion,
- 0 lors de la première connexion.
- -1 en cas d'erreur. Le compte-rendu détaillé de l'erreur est connu grâce à la fonction ErreurInfo utilisée avec la constante errCode ou errMessage.
En cas d'erreur d'identification, la fonction ErreurInfo utilisée avec la constante errCode renvoie la constante ftpErreurIdentification.
<Serveur> : Chaîne de caractères Nom du serveur FTP (par exemple "ftp.cdrom.com") ou adresse IP du serveur FTP (par exemple "192.54.12.8"). <Nom de l'utilisateur> : Chaîne de caractères optionnelle - Nom de l'utilisateur qui tente d'effectuer une connexion nominative (identification de l'utilisateur sur le serveur FTP). Ce paramètre est donné par le responsable du site FTP.
- Chaîne vide ("") pour effectuer une connexion anonyme.
<Mot de passe> : Chaîne de caractères optionnelle Mot de passe de l'utilisateur : permet d'identifier l'utilisateur sur le serveur FTP. Ce paramètre est donné par le responsable du site FTP.Ce mot de passe correspond : - au <Mot de passe> spécifié si ce paramètre est différent d'une chaîne vide (""),
- à l'adresse email de l'utilisateur si le paramètre <Nom de l'utilisateur> n'est pas spécifié ou est égal à une chaîne vide (""),
- à une chaîne vide ("") si ce paramètre n'est pas spécifié et si le paramètre <Nom de l'utilisateur> est différent d'une chaîne vide ("").
Remarque : Si le mot de passe contient des caractères spéciaux, il peut être nécessaire de le convertir en UTF8 en utilisant la fonction ChaîneVersUTF8. <Numéro de port> : Entier optionnel Numéro de port sur lequel le serveur doit être lancé. Ce paramètre est donné par le responsable du site FTP.Par défaut : - pour une connexion non sécurisée, ce port est le port 21.
![Android Android](https://doc.pcsoft.fr/ext/images/fr/ANDROID.png?385929803) pour une connexion sécurisée en mode FTPS, ce port est le port 990. ![Android Android](https://doc.pcsoft.fr/ext/images/fr/ANDROID.png?385929803) pour une connexion sécurisée en mode FTPES, ce port est le port 21. ![Android Android](https://doc.pcsoft.fr/ext/images/fr/ANDROID.png?385929803) pour une connexion sécurisée en mode SFTP, ce port est le port 22.
<Type de connexion> : Constante optionnelle de type Entier Type de connexion à effectuer :
| | ftpModeActif (ou Faux par compatibilité) | Connexion active au serveur FTP. Lors d'un transfert de fichiers, c'est le client qui prend l'initiative du transfert. Ce type de connexion peut être refusé par certains serveurs FTP protégés. | ftpModePassif (ou Vrai par compatibilité) (Valeur par défaut) | Connexion passive au serveur FTP (mode PASV). Lors d'un transfert de fichiers, c'est le serveur qui prend l'initiative du transfert. Ce type de connexion permet de franchir certains "firewalls". Remarque : Si la connexion au serveur est en IPV6, alors la connexion se fera en mode passif étendu (car le mode passif ne supporte pas IPV6). | ftpModePassifEtendu | Connexion passive étendue au serveur FTP (mode EPSV). Lors d'un transfert de fichiers, c'est le serveur qui prend l'initiative du transfert. Ce type de connexion permet de franchir certains "firewalls". Si le serveur ne supporte pas le mode passif étendu (la commande FEAT est envoyée au serveur pour connaître la capacité), la connexion est dégradée en mode passif simple. Limitations : - Ce mode n'est pas supporté lors de l'utilisation du module "wininet" de Windows (voir fonction FTPParamètre) : la connexion est réalisée en mode ftpModePassif.
![Android Android](https://doc.pcsoft.fr/ext/images/fr/ANDROID.png?385929803) Constante non disponible.
| ftpModePassifIgnoreIP | Connexion passive au serveur FTP (mode PASV). Lors d'un transfert de fichiers en mode passif le serveur donne le port et l'adresse IP pour le transfert des données. Avec ce paramètre, seul le port est pris en compte, l'adresse IP est ignorée. Ce type de connexion permet d'utiliser des serveurs FTP qui retournent des adresses IP non routables mais qui sont joignables par l'adresse IP de connexion Limitations : - Ce mode n'est pas supporté lors de l'utilisation du module "wininet" de Windows (voir fonction FTPParamètre) : la connexion est réalisée en mode ftpModePassif.
![Android Android](https://doc.pcsoft.fr/ext/images/fr/ANDROID.png?385929803) Constante non disponible.
|
<Délai de connexion> : Entier optionnel ou Durée optionnelle Nombre de secondes au bout desquelles la requête de connexion au serveur FTP est abandonnée (par défaut 20). Ce délai s'applique à toutes les opérations FTP réalisées sur cette connexion. Si aucune réponse du serveur n'est obtenue dans le <Délai de connexion> spécifié, la fonction FTPConnecte retourne -1. Remarque : Ce paramètre peut correspondre à : - un entier correspondant au nombre de secondes,
- une variable de type Durée,
- l'indication directe de la durée (par exemple '1s').
<Clé privée> : Chaîne de caractères optionnelle <Mot de passe de la clé> : Chaîne de caractères ANSI optionnelle
Liste des exemples associés :
|
Exemples unitaires (WEBDEV) : Les fonctions FTP
[ + ] Utilisation des principales fonctions FTP de WEBDEV pour : - Se connecter à un serveur FTP - Lister les fichiers et les répertoires présents sur le serveur FTP - Récupérer des fichiers présents sur le serveur FTP - Se déconnecter d'un serveur FTP
|
|
Exemples complets (WINDEV) : WD Transfert de fichiers par FTP
[ + ] WD Transfert de fichiers par FTP Cet exemple est un client FTP complet vous permettant de mémoriser plusieurs serveurs FTP. Vous pouvez alors effectuer des transferts multi-fichiers du poste local vers le serveur ou du serveur FTP vers le poste local. On utilise pour cela les fonctions standards du WLangage (FTPConnecte, etc...)
|
Composante : wd300com.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|