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, dans les TCHAR. Cette valeur inclut de l’espace pour la fin du caractère null. 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 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 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 .

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 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 Local MS-DOS Device. 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.

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

Examples

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

Spécifications

Voir aussi

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

Fonctions de gestion des volumes