GetLogicalDriveStringsA, fonction (winbase.h)

  • Article

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

Syntaxe

DWORD GetLogicalDriveStringsA(
  [in]  DWORD nBufferLength,
  [out] LPSTR lpBuffer
);

Paramètres

[in] nBufferLength

Taille maximale de la mémoire tampon pointée vers lpBuffer, dans les 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, plus 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 est 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 assez 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 .

Remarques

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 d’appareils MS-DOS globaux et locaux. S’il existe un lecteur 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 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 Obtention d’un nom de fichier à partir d’un handle de fichier.

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

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

Fonctions de gestion des volumes