Fonction FindFirstVolumeA (winbase.h)

  • Article

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

Voir aussi

FindNextVolume

FindVolumeClose

Dossiers montés

Fonctions de gestion des volumes