FindNextVolumeA, fonction (winbase.h)
Poursuit une recherche en volume démarrée par un appel à la fonction FindFirstVolume. FindNextVolume recherche un volume par appel.
Syntaxe
BOOL FindNextVolumeA(
[in] HANDLE hFindVolume,
[out] LPSTR lpszVolumeName,
[in] DWORD cchBufferLength
);
Paramètres
[in] hFindVolume
Handle de recherche de volume retourné par un appel précédent à la fonction FindFirstVolume .
[out] lpszVolumeName
Pointeur vers une chaîne qui reçoit le chemin d’accès GUID du volume trouvé.
[in] cchBufferLength
Longueur de la mémoire tampon qui reçoit le chemin du GUID du volume, en TCHAR.
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. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. Si aucun fichier correspondant n’est trouvé, la fonction GetLastError retourne le code d’erreur ERROR_NO_MORE_FILES . Dans ce cas, fermez la recherche avec la fonction FindVolumeClose .
Remarques
Une fois le handle de recherche établi en appelant FindFirstVolume, vous pouvez utiliser la fonction FindNextVolume pour rechercher d’autres volumes.
Vous ne devez supposer aucune corrélation entre l’ordre des volumes retournés par ces fonctions et l’ordre des volumes qui se trouvent sur l’ordinateur. En particulier, ne supposez aucune corrélation entre l’ordre des volumes et les lettres de lecteur attribuées par le BIOS (le cas échéant) ou l’administrateur de disque.
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 | No |
| Basculement transparent SMB 3.0 (TFO) | No |
| SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) | No |
| Système de fichiers du volume partagé de cluster (CsvFS) | Oui |
| Système de fichiers résilient (ReFS) | Oui |
SMB ne prend pas en charge les fonctions de gestion des volumes.
Exemples
Pour obtenir un exemple, consultez Affichage des chemins d’accès aux volumes.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winbase.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |