Fonction FindFirstVolumeMountPointA (winbase.h)

Récupère le nom d’un dossier monté sur le volume spécifié. FindFirstVolumeMountPoint est utilisée pour commencer à analyser les dossiers montés sur un volume.

Syntaxe

HANDLE FindFirstVolumeMountPointA(
  [in]  LPCSTR lpszRootPathName,
  [out] LPSTR  lpszVolumeMountPoint,
  [in]  DWORD  cchBufferLength
);

Paramètres

[in] lpszRootPathName

Chemin d’accès GUID du volume pour le volume à analyser pour les dossiers montés. Une barre oblique inverse de fin est requise.

[out] lpszVolumeMountPoint

Pointeur vers une mémoire tampon qui reçoit le nom du premier dossier monté trouvé.

[in] cchBufferLength

Longueur de la mémoire tampon qui reçoit le chemin d’accès au dossier monté, dans TCHARs.

Valeur retournée

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

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

Remarques

La fonction FindFirstVolumeMountPoint ouvre un handle de recherche de dossier monté et retourne des informations sur le premier dossier monté qui se trouve sur le volume spécifié. Une fois le handle de recherche établi, vous pouvez utiliser la fonction FindNextVolumeMountPoint pour rechercher d’autres dossiers montés. Lorsque le handle de recherche n’est plus nécessaire, fermez-le avec la fonction FindVolumeMountPointClose .

Les fonctions FindFirstVolumeMountPoint, FindNextVolumeMountPoint et FindVolumeMountPointClose retournent les chemins d’accès aux dossiers montés pour un volume spécifié. Ils ne retournent pas de lettres de lecteur ou de chemins GUID de volume. Pour plus d’informations sur l’énumération des chemins GUID de volume pour un volume, consultez Énumération des chemins d’accès GUID de volume.

Vous ne devez supposer aucune corrélation entre l’ordre des dossiers montés qui sont retournés par ces fonctions et l’ordre des dossiers montés qui sont retournés par d’autres fonctions ou outils.

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)	Non
Système de fichiers du volume partagé de cluster (CsvFS)	Non
Système de fichiers résilient (ReFS)	Non

 

SMB ne prend pas en charge les fonctions de gestion des volumes. CsvFS ne prend pas en charge l’ajout d’un point de montage sur un volume CSV. ReFS n’indexe pas les points de montage.

Notes

L’en-tête winbase.h définit FindFirstVolumeMountPoint comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

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

FindNextVolumeMountPoint

FindVolumeMountPointClose

Dossiers montés

Fonctions de gestion des volumes