FindNextFileNameW, fonction (fileapi.h)
Poursuit l’énumération des liens durs vers un fichier à l’aide du handle retourné 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 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.
Remarques
Si la fonction retourne TRUE, il existe des liens plus 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 SMB (Server Message Block) 3.0 | Yes |
| Basculement transparent SMB 3.0 (TFO) | No |
| SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) | No |
| Cluster Shared Volume File System (CsvFS) | Yes |
| Système de fichiers résilient (ReFS) | Yes |
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 |