FindNextVolumeW, fonction (fileapi.h)

  • Article

Poursuit une recherche en volume démarrée par un appel à la fonction FindFirstVolume. FindNextVolume recherche un volume par appel.

Syntaxe

BOOL FindNextVolumeW(
  [in]  HANDLE hFindVolume,
  [out] LPWSTR 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 .

Notes

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 Non
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
 

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.

Spécifications

   
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 fileapi.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

FindFirstVolume

FindVolumeClose

Dossiers montés

Fonctions de gestion des volumes