GetLogicalDriveStringsW, fonction (fileapi.h)

  • Article

Remplit une mémoire tampon avec des chaînes qui spécifient des lecteurs valides dans le système.

Syntaxe

DWORD GetLogicalDriveStringsW(
  [in]  DWORD  nBufferLength,
  [out] LPWSTR lpBuffer
);

Paramètres

[in] nBufferLength

Taille maximale de la mémoire tampon pointée par lpBuffer, en TCHAR. Cette taille n’inclut pas le caractère null de fin. Si ce paramètre est égal à zéro, lpBuffer n’est pas utilisé.

[out] lpBuffer

Pointeur vers une mémoire tampon qui reçoit une série de chaînes terminées par null, une pour chaque lecteur valide dans le système, ainsi qu’un caractère Null supplémentaire. Chaque chaîne est un nom d’appareil.

Valeur retournée

Si la fonction réussit, la valeur de retour correspond à la longueur, en caractères, des chaînes copiées dans la mémoire tampon, sans inclure le caractère null de fin. Notez qu’un caractère NULL ANSI-ASCII utilise un octet, mais qu’un caractère Null Unicode (UTF-16) utilise deux octets.

Si la mémoire tampon n’est pas suffisamment grande, la valeur de retour est supérieure à nBufferLength. Il s’agit de la taille de la mémoire tampon requise pour contenir les chaînes de lecteur.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, utilisez la fonction GetLastError .

Notes

Chaque chaîne de la mémoire tampon peut être utilisée partout où un répertoire racine est requis, par exemple pour les fonctions GetDriveType et GetDiskFreeSpace .

Cette fonction retourne une concaténation des lecteurs dans les espaces de noms Global et Local MS-DOS Device. Si un lecteur existe dans les deux espaces de noms, cette fonction retourne l’entrée dans l’espace de noms Appareil MS-DOS local. Pour plus d’informations, consultez Définition d’un nom d’appareil MS DOS.

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) Oui
 

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

Exemples

Pour obtenir un exemple, consultez Obtention d’un nom de fichier à partir d’un handle de fichier.

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

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

Fonctions de gestion des volumes