Funzione GetLogicalDriveStringsW (fileapi.h)

Articolo
03/14/2023

Riempie un buffer con stringhe che specificano unità valide nel sistema.

Sintassi

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

Parametri

[in] nBufferLength

Dimensioni massime del buffer a cui punta lpBuffer, in TCHARs. Questa dimensione non include il carattere Null terminante. Se questo parametro è zero, lpBuffer non viene usato.

[out] lpBuffer

Puntatore a un buffer che riceve una serie di stringhe con terminazione null, una per ogni unità valida nel sistema, oltre a un carattere Null aggiuntivo. Ogni stringa è un nome del dispositivo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è la lunghezza, in caratteri, delle stringhe copiate nel buffer, non incluso il carattere Null di terminazione. Si noti che un carattere null ANSI-ASCII usa un byte, ma un carattere Unicode (UTF-16) null usa due byte.

Se il buffer non è sufficiente, il valore restituito è maggiore di nBufferLength. È la dimensione del buffer necessaria per contenere le stringhe di unità.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, usare la funzione GetLastError .

Commenti

Ogni stringa nel buffer può essere usata ovunque sia necessaria una directory radice, ad esempio per le funzioni GetDriveType e GetDiskFreeSpace .

Questa funzione restituisce una concatenazione delle unità nello spazio dei nomi Dispositivo MS-DOS globale e locale. Se esiste un'unità in entrambi gli spazi dei nomi, questa funzione restituirà la voce nello spazio dei nomi Dispositivo MS-DOS locale. Per altre informazioni, vedere Definizione di un nome del dispositivo MS DOS.

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia	Supportato
Protocollo SMB (Server Message Block) 3.0	No
Failover trasparente SMB 3.0 (TFO)	No
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO)	No
File system del volume condiviso del cluster (CsvFS)	Sì
File system resiliente (ReFS)	Sì

SMB non supporta le funzioni di gestione dei volumi.

Esempio

Per un esempio, vedere Ottenere un nome file da un handle file.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	fileapi.h (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll