|
|
|
|
|
|
|
|
|
|
version 2003 (Modifiée)
FTP_GetDirList (ftp_ID; cheminServeur; noms; tailles; types; datesModif{; heuresModif}) 
Entier
| Paramètre | Type | Description | |
| ftp_ID | Entier long | | Référence d'une connexion FTP |
| cheminServeur | Texte | | Chemin d'accès à un répertoire Unix sur le |
| serveur FTP | |||
 | Répertoire de travail courant (CWD) | ||
| noms | Tab Alpha | Txt | | Liste de noms |
| tailles | Tab Entier long | | Liste de tailles |
| types | Tab Entier long | | Liste de types |
| 0 = fichier normal, | |||
| 1 = répertoire, | |||
| 2 = fichier spécial de type bloc, | |||
| 3 = fichier spécial de type caractère, | |||
| 4 = lien symbolique, | |||
| 5 = fichier spécial FIFO, | |||
| 6 = porte d'accès de la famille d'adresses AF_UNIX | |||
| datesModif | Tab Date | | Liste des dates de modification |
| heuresModif | Tab Entier long | | Liste des heures de modification |
| Résultat | Entier | | Code d'erreur |
Description
La commande FTP_GetDirList retourne la liste des objets présents dans le répertoire cheminServeur de la session FTP identifiée par ftp_ID. Le nom, la taille, le type, la date et, facultativement, l'heure de modification des éléments du répertoire cheminServeur sont renvoyés dans des tableaux. Une connexion au site FTP doit avoir déjà été ouverte par FTP_Login et être toujours valide (FTP_VerifyID). La commande FTP_GetDirList remplace le répertoire de travail courant (ou CWD, Current Working Directory) par celui défini dans le paramètre cheminServeur.
ftp_ID est l'identifiant de la session FTP établie avec FTP_Login.
Le paramètre cheminServeur contient un chemin d'accès au format Unix référençant un répertoire FTP. Il est fortement recommandé de passer une variable ou un champ 4D dans ce paramètre car le répertoire de travail courant résultant lui sera retourné après l'exécution de la commande. Généralement, la valeur renvoyée sera identique à celle qui a été passée. Toutefois, dans certains cas (par exemple des restrictions d'accès), le changement de répertoire a échoué. Le paramètre cheminServeur contient alors le chemin d'accès du répertoire courant du serveur pour la session.
Si vous passez une chaîne vide dans ce paramètre, les tableaux sont remplis avec la liste des fichiers du répertoire courant et le chemin d'accès du répertoire courant du serveur (CWD) est retourné dans le paramètre cheminServeur.
noms est un tableau de type alphanumérique ou texte recevant le nom de chaque objet présent dans le répertoire cheminServeur spécifié.
tailles est un tableau de type entier long recevant la taille des objets du répertoire cheminServeur.
types est un tableau de type entier long recevant les valeurs de type de chaque objet du répertoire cheminServeur. Voici les valeurs possibles et les types correspondants :
| Type | Fichier |
| 0 | fichier ordinaire |
| 1 | répertoire |
| 2 | fichier spécial de type bloc |
| 3 | fichier spécial de type caractère |
| 4 | lien symbolique (alias vers des fichiers ou des dossiers) |
| 5 | fichier spécial FIFO |
| 6 | porte d'accès de la famille AF_UNIX |
Note : Dans le cas d'un lien symbolique (type=4), le serveur FTP retourne un chemin d'accès particulier (Nom d'alias + symbole + chemin d'accès au fichier ou dossier source). Si vous tentez d'utiliser ce chemin pour accéder au fichier ou dossier source, une erreur sera retournée. Vous devez extraire le chemin d'accès du fichier ou du dossier à partir de la chaîne retournée par FTP_GetDirList. Ce chemin d'accès débute immédiatement après le caractère symbole. Sinon, les commandes telles que FTP_GetFileInfo retourneront l'erreur -10085 puisque le fichier ou le dossier ne sera pas trouvé.
datesModif est un tableau de type date recevant la date de dernière modification de chaque objet du répertoire cheminServeur.
heuresModif est un tableau de type entier long recevant l'heure de dernière modification de chaque objet du répertoire cheminServeur.
Rappel : Dans 4D, le type de tableau entier long est utilisé pour manipuler les données de type heure. Chaque élément du tableau représente un nombre de secondes. Utilisez la commande Chaine heure pour convertir ces valeurs au format HH:MM:SS.
Référence
FTP_ChangeDir, FTP_Login, FTP_PrintDir, FTP_VerifyID.
|
|
|
|
|
|
|
|
|
|