GetLogicalDriveStringsW, fonction (fileapi.h)
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 |