GetVolumePathNamesForVolumeNameW, fonction (fileapi.h)

  • Article

Récupère une liste de lettres de lecteur et de chemins 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

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

Voir aussi

Dossiers montés

Fonctions de gestion des volumes