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.

SMB non supporta le funzioni di gestione dei volumi.

Esempio

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

Requisiti

Vedere anche

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

Funzioni di gestione dei volumi