Fonction FindFirstVolumeA (winbase.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 FindFirstVolumeA(
[out] LPSTR 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 d’accès GUID du volume, en TCHAR.
Valeur retournée
Si la fonction réussit, la valeur de retour est un handle de recherche utilisé dans un appel ultérieur aux fonctions FindNextVolume et FindVolumeClose .
Si la fonction ne parvient pas à trouver des volumes, la valeur de retour est le code d’erreur INVALID_HANDLE_VALUE . Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
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 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 |