UDF > WinAPIEx > Files & Devices > Files >


_WinAPI_EnumFiles

Énumère les fichiers et sous-répertoires du répertoire spécifié avec un nom qui concorde avec le modèle

#include <WinAPIFiles.au3>
_WinAPI_EnumFiles ( $sDir [, $iFlag = 0 [, $sTemplate = '' [, $bExclude = False]]] )

Paramètres

$sDir Le chemin d'accès au répertoire.
$iFlag [optionnel] Le flag qui indique s'il faut énumérer les fichiers, sous-répertoires, ou les deux.
Ce paramètre peut être prendre une des valeurs suivantes:
    0 - Énumère à la fois les fichiers et les sous-répertoires (par défaut).
    1 - Énumère seulement les fichiers.
    2 - Énumère seulement les sous-répertoires.
$sTemplate [optionnel] Le modèle à utiliser pour l'énumération des fichiers et des répertoires. Par exemple,"*.jpe;*.jpeg;*.jpg".
$bExclude [optionnel] Indique si le modèle spécifié est utilisé pour exclure les fichiers, les valeurs valides sont:
    True - Les fichiers concordant au modèle ne seront pas énumérés.
    False - Seuls les fichiers concordant au modèle seront énumérés (par défaut).

Valeur de retour

Succès: Retourne un tableau 2D contenant les informations suivantes :
    [0][0] - Nombre de lignes dans le tableau (n)
    [0][i] - Inutilisé pour 1 <= i <= 6
    [n][0] - Le nom du fichier.
    [n][1] - La date et l'heure (UTC) de création du fichier.
    [n][2] - La date et l'heure (UTC) du dernier accès au fichier.
    [n][3] - La date et l'heure (UTC) de la dernière modification du fichier.
    [n][4] - La taille du fichier, en octets.
    [n][5] - La taille d'allocation du fichier, en octets.
    [n][6] - Les attributs de fichiers ($FILE_ATTRIBUTE_*).
Échec: Définit @error <> 0, @extended peut contient le code d'erreur NTSTATUS.

Remarque

Si le répertoire cible est vide ou si aucun fichier concorde aux critères indiqués, la fonction retourne encore un tableau où l'élément [0][0] du tableau contient la valeur 0.

Voir aussi

Consultez ZwQueryDirectoryFile dans la librairie MSDN.

Exemple

#include <Array.au3>
#include <WinAPIFiles.au3>

Local $aData = _WinAPI_EnumFiles(@SystemDir, 1, '*.ax;*.cpl;*.dll;*.drv;*.exe;*.ocx;*.scr')

_ArrayDisplay($aData, '_WinAPI_EnumFiles')