GetVolumeNameForVolumeMountPointA, fonction (winbase.h)
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 |