GetVolumeNameForVolumeMountPointW, fonction (fileapi.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 GetVolumeNameForVolumeMountPointW(
  [in]  LPCWSTR lpszVolumeMountPoint,
  [out] LPWSTR  lpszVolumeName,
  [in]  DWORD   cchBufferLength
);

Paramètres

[in] lpszVolumeMountPoint

Pointeur vers une chaîne qui contient le chemin 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 de fin ('\').

[out] lpszVolumeName

Pointeur vers une chaîne qui reçoit le chemin du GUID du volume. Ce chemin d’accès se présente sous 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 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.

Notes

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 Affectation de noms à 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 Non
Basculement transparent SMB 3.0 (TFO) Non
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) Oui
Système de fichiers résilient (ReFS) Non
 

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.

Spécifications

   
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 fileapi.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

DeleteVolumeMountPoint

GetVolumePathName

Dossiers montés

SetVolumeMountPoint

Fonctions de gestion des volumes