FindNextFileA, fonction (fileapi.h)

Article
03/04/2024

Poursuit une recherche de fichiers à partir d’un appel précédent aux fonctions FindFirstFile, FindFirstFileEx ou FindFirstFileTransacted.

Syntaxe

BOOL FindNextFileA(
  [in]  HANDLE             hFindFile,
  [out] LPWIN32_FIND_DATAA lpFindFileData
);

Paramètres

[in] hFindFile

Handle de recherche retourné par un appel précédent à la fonction FindFirstFile ou FindFirstFileEx .

[out] lpFindFileData

Pointeur vers la structure WIN32_FIND_DATA qui reçoit des informations sur le fichier ou le sous-répertoire trouvé.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro et le paramètre lpFindFileData contient des informations sur le fichier ou répertoire suivant trouvé.

Si la fonction échoue, la valeur de retour est zéro et le contenu de lpFindFileData est indéterminé. Pour obtenir des informations détaillées sur l’erreur, appelez la fonction GetLastError.

Si la fonction échoue parce qu’il n’y a plus de fichiers correspondants, la fonction GetLastError retourne ERROR_NO_MORE_FILES.

Remarques

Cette fonction utilise les mêmes filtres de recherche que ceux utilisés pour créer le handle de recherche passé dans le paramètre hFindFile . Pour plus d’informations, consultez FindFirstFile et FindFirstFileEx.

L’ordre dans lequel la recherche retourne les fichiers, tel que l’ordre alphabétique, n’est pas garanti et dépend du système de fichiers. Si les données doivent être triées, l’application doit effectuer le classement après avoir obtenu tous les résultats.

Note Dans de rares cas ou sur un système fortement chargé, les informations d’attribut de fichier sur les systèmes de fichiers NTFS peuvent ne pas être à jour au moment où cette fonction est appelée. Pour obtenir les attributs de fichier du système de fichiers NTFS actuels, appelez la fonction GetFileInformationByHandle .

L’ordre dans lequel cette fonction retourne les noms de fichiers dépend du type de système de fichiers. Avec le système de fichiers NTFS et les systèmes de fichiers CDFS, les noms sont généralement retournés par ordre alphabétique. Avec les systèmes de fichiers FAT, les noms sont généralement retournés dans l’ordre dans lequel les fichiers ont été écrits sur le disque, ce qui peut ou non être dans l’ordre alphabétique. Toutefois, comme indiqué précédemment, ces comportements ne sont pas garantis.

Si le chemin pointe vers un lien symbolique, la mémoire tampon WIN32_FIND_DATA contient des informations sur le lien symbolique, et non sur la cible.

Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

Technologie	Prise en charge
Protocole Server Message Block (SMB) 3.0	Oui
Basculement transparent SMB 3.0 (TFO)	Oui
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO)	Oui
Système de fichiers du volume partagé de cluster (CsvFS)	Oui
Système de fichiers résilient (ReFS)	Oui

Opérations traitées

S’il existe une transaction liée au descripteur d’énumération de fichiers, les fichiers retournés sont soumis aux règles d’isolation des transactions.

Exemples

Pour obtenir un exemple, consultez Liste des fichiers dans un répertoire.

Notes

L’en-tête fileapi.h définit FindNextFile en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	fileapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll