GetVolumePathNamesForVolumeNameA, fonction (winbase.h)

Article
03/03/2024

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

Syntaxe

BOOL GetVolumePathNamesForVolumeNameA(
  [in]  LPCSTR lpszVolumeName,
  [out] LPCH   lpszVolumePathNames,
  [in]  DWORD  cchBufferLength,
  [out] PDWORD lpcchReturnLength
);

Paramètres

[in] lpszVolumeName

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

[out] lpszVolumePathNames

Pointeur vers une mémoire tampon qui reçoit la liste des lettres de lecteur et des chemins d’accès aux dossiers montés. La liste est un tableau de chaînes terminées par un caractère NULL supplémentaire. Si la mémoire tampon n’est pas assez grande pour contenir la liste complète, la mémoire tampon contient la plus grande partie possible de la liste.

[in] cchBufferLength

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

[out] lpcchReturnLength

Si l’appel réussit, ce paramètre est le nombre de TCHAR copiés dans la mémoire tampon lpszVolumePathNames . Sinon, ce paramètre correspond à la taille de la mémoire tampon requise pour contenir la liste complète, dans les TCHAR.

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. Si la mémoire tampon n’est pas assez 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	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)	Oui

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

Exemples

Pour obtenir un exemple, consultez Affichage des chemins d’accès aux volumes.

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

Dossiers montés

Fonctions de gestion des volumes

Partager via