Funzione GetLogicalDriveStringsA (winbase.h)
Riempie un buffer con stringhe che specificano unità valide nel sistema.
Sintassi
DWORD GetLogicalDriveStringsA(
[in] DWORD nBufferLength,
[out] LPSTR lpBuffer
);
Parametri
[in] nBufferLength
Dimensione massima del buffer a cui punta lpBuffer, in TCHAR. Questa dimensione non include il carattere Null di terminazione. 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 di dispositivo.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è la lunghezza, in caratteri, delle stringhe copiate nel buffer, senza includere il carattere Null di terminazione. Si noti che un carattere Null ANSI-ASCII usa un byte, ma un carattere Null Unicode (UTF-16) usa due byte.
Se il buffer non è sufficientemente grande, 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à negli spazi dei nomi Global e Local MS-DOS Device. Se un'unità esiste in entrambi gli spazi dei nomi, questa funzione restituirà la voce nello spazio dei nomi Local MS-DOS Device. Per altre informazioni, vedere Definizione di un nome 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 di scalabilità orizzontale (SO) | No |
| File system del volume condiviso cluster (CsvFS) | Sì |
| Resilient File System (ReFS) | Sì |
SMB non supporta le funzioni di gestione dei volumi.
Esempio
Per un esempio, vedere Recupero di un nome file da un handle di file.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |