Fonction FindFirstVolumeW (fileapi.h)

Récupère le nom d’un volume sur un ordinateur. FindFirstVolume est utilisé pour commencer à analyser les volumes d’un ordinateur.

Syntaxe

HANDLE FindFirstVolumeW(
  [out] LPWSTR lpszVolumeName,
  [in]  DWORD  cchBufferLength
);

Paramètres

[out] lpszVolumeName

Pointeur vers une mémoire tampon qui reçoit une chaîne terminée par null qui spécifie un chemin d’accès GUID de volume pour le premier volume trouvé.

[in] cchBufferLength

Longueur de la mémoire tampon pour recevoir le chemin du GUID de volume, dans les TCHAR.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle de recherche utilisé dans un appel suivant aux fonctions FindNextVolume et FindVolumeClose .

Si la fonction ne parvient pas à trouver des volumes, la valeur renvoyée est le code d’erreur INVALID_HANDLE_VALUE . Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

La fonction FindFirstVolume ouvre un handle de recherche de volume et retourne des informations sur le premier volume trouvé sur un ordinateur. Une fois le handle de recherche établi, vous pouvez utiliser la fonction FindNextVolume pour rechercher d’autres volumes. Lorsque le handle de recherche n’est plus nécessaire, fermez-le à l’aide de la fonction FindVolumeClose .

Vous ne devez pas supposer une 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 de volume.

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

FindNextVolume

FindVolumeClose

Dossiers montés

Fonctions de gestion des volumes