GetVolumeNameForVolumeMountPointA, fonction (winbase.h)

  • Article

Récupère un chemin du GUID du volume associé au point de montage de volume spécifié (lettre de lecteur, chemin du GUID du volume ou dossier monté).

Syntaxe

BOOL GetVolumeNameForVolumeMountPointA(
  [in]  LPCSTR lpszVolumeMountPoint,
  [out] LPSTR  lpszVolumeName,
  [in]  DWORD  cchBufferLength
);

Paramètres

[in] lpszVolumeMountPoint

Pointeur vers une chaîne qui contient le chemin d’accès d’un dossier monté (par exemple, « Y :\MountX ») ou une lettre de lecteur (par exemple, « X :\ »). La chaîne doit se terminer par une barre oblique inverse ('').

[out] lpszVolumeName

Pointeur vers une chaîne qui reçoit le chemin du GUID de volume. Ce chemin d’accès est de la forme « \ ?\Volume{GUID} », où GUID est un GUID qui identifie le volume. S’il existe plusieurs chemins GUID de volume pour le volume, seul le premier dans le cache du gestionnaire de montage est retourné.

[in] cchBufferLength

Longueur de la mémoire tampon de sortie, en TCHAR. Une taille raisonnable pour la mémoire tampon afin de prendre en charge le chemin d’accès GUID de volume le plus grand possible est de 50 caractères.

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.

Remarques

Utilisez GetVolumeNameForVolumeMountPoint pour obtenir un chemin d’accès GUID de volume à utiliser avec des fonctions telles que SetVolumeMountPoint et FindFirstVolumeMountPoint qui nécessitent un chemin d’accès GUID de volume en tant que paramètre d’entrée. Pour plus d’informations sur les chemins GUID de volume, consultez Nommer un volume.

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) No
 

SMB ne prend pas en charge les fonctions de gestion des volumes.

Les points de montage ne sont pas pris en charge par les volumes ReFS.

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

DeleteVolumeMountPoint

GetVolumePathName

Dossiers montés

SetVolumeMountPoint

Fonctions de gestion des volumes