GetVolumePathNamesForVolumeNameW, fonction (fileapi.h)

Article
11/20/2024

Récupère une liste de lettres de lecteur et de chemins d’accès de dossier montés pour le volume spécifié.

Syntaxe

BOOL GetVolumePathNamesForVolumeNameW(
  [in]  LPCWSTR lpszVolumeName,
  [out] LPWCH   lpszVolumePathNames,
  [in]  DWORD   cchBufferLength,
  [out] PDWORD  lpcchReturnLength
);

Paramètres

[in] lpszVolumeName

Un volume GUID chemin d’accès pour le volume. Un guid de volume se présente sous la forme « \\ ?\Volume{xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxx}\ ».

[out] lpszVolumePathNames

Pointeur vers une mémoire tampon qui reçoit la liste des lettres de lecteur et des chemins de dossier montés. La liste est un tableau de chaînes se terminant par une null supplémentaire caractère. Si la mémoire tampon n’est pas suffisamment grande pour contenir la liste complète, la mémoire tampon contient autant de la liste que possible.

[in] cchBufferLength

Longueur de la mémoire tampon lpszVolumePathNames , dans WCHAR, y compris tous les caractères NULL.

[out] lpcchReturnLength

Si l’appel réussit, ce paramètre correspond au nombre de WCHAR copiés dans la mémoire tampon lpszVolumePathNames. Dans le cas contraire, ce paramètre est la taille de la mémoire tampon requise pour contenir la liste complète, dans WCHARs.

Valeur de retour

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’erreur étendues, appelez GetLastError. Si la mémoire tampon n’est pas suffisamment grande pour contenir la liste complète, le code d’erreur est ERROR_MORE_DATA et le paramètre lpcchReturnLength reçoit la taille de mémoire tampon requise.

Remarques

Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

Technologie	Supporté
Protocole SMB (Server Message Block) 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
Cluster Shared Volume File System (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 de volume.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	fileapi.h (include Windows.h)
bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

dossiers montés

fonctions de gestion des volumes

Partager via