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

Dimensione massima del buffer a cui punta lpBuffer, in TCHAR. Questo valore include lo spazio per 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 estese sull'errore, usare la funzione GetLastError .

Osservazioni:

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 di dispositivo MS DOS.

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

Tecnologia	Sostenuto
Protocollo SMB (Server Message Block) 3.0	No
SMB 3.0 Transparent Failover (TFO)	No
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO)	No
Cluster Shared Volume File System (CsvFS)	Sì
Resilient File System (ReFS)	Sì

 

SMB non supporta le funzioni di gestione dei volumi.

Esempi

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

Requisiti

Requisito	Value
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Header	fileapi.h (include Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

Funzioni di gestione dei volumi