4D Internet Commands v16

FTP_GetDirList

Accueil

 
4D Internet Commands v16
FTP_GetDirList

FTP_GetDirList 


 

FTP_GetDirList ( ftp_ID ; cheminServeur ; tabNoms ; tailles ; types ; datesModif ; heuresModif ) -> Résultat 
Paramètre Type   Description
ftp_ID  Entier long in Référence d'une connexion FTP
cheminServeur  Texte in Chemin d'accès à un répertoire Unix sur le serveur FTP
in Répertoire de travail courant (CWD)
tabNoms  Tableau chaîne in Liste de noms
tailles  Tableau entier long in Liste de tailles
types  Tableau entier in 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  Tableau date in Liste des dates de modification
heuresModif  Tableau entier long in Liste des heures de modification
Résultat  Entier in Code d'erreur

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 recevant les valeurs de type de chaque objet du répertoire cheminServeur. Voici les valeurs possibles et les types correspondants :

TypeFichier
0fichier ordinaire
1répertoire
2fichier spécial de type bloc
3fichier spécial de type caractère
4lien symbolique (alias vers des fichiers ou des dossiers)
5fichier spécial FIFO
6porte 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.



Voir aussi  

FTP_ChangeDir
FTP_Login
FTP_PrintDir
FTP_VerifyID

 
PROPRIÉTÉS 

Produit : 4D Internet Commands
Thème : IC File Transfer
Numéro : 88944
Nom intl. : FTP_GetDirList

 
HISTORIQUE 

Modifié : 4D Internet Commands 2003

 
UTILISATION DE L'ARTICLE

4D Internet Commands ( 4D Internet Commands v16)