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