Funzione GetDiskFreeSpaceA (fileapi.h)
Recupera informazioni sul disco specificato, inclusa la quantità di spazio disponibile sul disco.
Sintassi
BOOL GetDiskFreeSpaceA(
[in] LPCSTR lpRootPathName,
[out] LPDWORD lpSectorsPerCluster,
[out] LPDWORD lpBytesPerSector,
[out] LPDWORD lpNumberOfFreeClusters,
[out] LPDWORD lpTotalNumberOfClusters
);
Parametri
[in] lpRootPathName
Directory radice del disco per cui devono essere restituite le informazioni. Se questo parametro è NULL, la funzione usa la radice del disco corrente. Se questo parametro è un nome UNC, deve includere una barra rovesciata finale, ad esempio "\\MyServer\MyShare\"). Inoltre, una specifica di unità deve avere una barra rovesciata finale ,ad esempio "C:\"). L'applicazione chiamante deve avere diritti di accesso FILE_LIST_DIRECTORY per questa directory.
[out] lpSectorsPerCluster
Puntatore a una variabile che riceve il numero di settori per cluster.
[out] lpBytesPerSector
Puntatore a una variabile che riceve il numero di byte per settore.
[out] lpNumberOfFreeClusters
Puntatore a una variabile che riceve il numero totale di cluster gratuiti nel disco disponibile per l'utente associato al thread chiamante.
Se le quote del disco per utente sono in uso, questo valore può essere minore del numero totale di cluster gratuiti nel disco.
[out] lpTotalNumberOfClusters
Puntatore a una variabile che riceve il numero totale di cluster nel disco disponibile per l'utente associato al thread chiamante.
Se le quote del disco per utente sono in uso, questo valore può essere minore del numero totale di cluster nel disco.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
La funzione GetDiskFreeSpaceEx consente di evitare alcuni degli aritmetici richiesti dalla funzione GetDiskFreeSpace .
Comportamento di collegamento simbolico: se il percorso punta a un collegamento simbolico, l'operazione viene eseguita nella destinazione.
Nota
L'intestazione fileapi.h definisce GetDiskFreeSpace come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | fileapi.h (includere Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |