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.

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

Vedere anche

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

Funzioni di gestione dei volumi