FindNextFileNameW, fonction (fileapi.h)

Article
08/23/2023

Poursuit l’énumération des liens directs vers un fichier en utilisant le gestionnaire renvoyé par un appel réussi à la fonction FindFirstFileNameW.

Syntaxe

BOOL FindNextFileNameW(
  [in]      HANDLE  hFindStream,
  [in, out] LPDWORD StringLength,
  [in, out] PWSTR   LinkName
);

Paramètres

[in] hFindStream

Handle de l’énumération retournée par un appel réussi à FindFirstFileNameW.

[in, out] StringLength

Taille du paramètre LinkName , en caractères. Si cet appel échoue et que l’erreur est ERROR_MORE_DATA, la valeur retournée par ce paramètre est la taille que LinkName doit avoir pour contenir toutes les données.

[in, out] LinkName

Pointeur vers une mémoire tampon pour stocker le premier nom de lien trouvé pour lpFileName.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro (0). Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Si aucun fichier correspondant n’est trouvé, la fonction GetLastError retourne ERROR_HANDLE_EOF.

Notes

Si la fonction retourne TRUE, il y a plus de liens durs à énumérer.

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)	Non
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO)	Non
Système de fichiers du volume partagé de cluster (CsvFS)	Oui
Système de fichiers résilient (ReFS)	Oui

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	fileapi.h (inclure Windows.h, WinBase.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

Fonctions de gestion des fichiers

FindClose

FindFirstFileNameW

Share via