Funzione GetDiskFreeSpaceW (fileapi.h)
Recupera informazioni sul disco specificato, inclusa la quantità di spazio disponibile sul disco.
Sintassi
BOOL GetDiskFreeSpaceW(
[in] LPCWSTR 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 FILE_LIST_DIRECTORY diritti di accesso 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 liberi sul disco disponibili per l'utente associato al thread chiamante.
Se le quote dei dischi per utente sono in uso, questo valore può essere inferiore al numero totale di cluster gratuiti sul disco.
[out] lpTotalNumberOfClusters
Puntatore a una variabile che riceve il numero totale di cluster sul disco disponibili per l'utente associato al thread chiamante.
Se le quote dei dischi per utente sono in uso, questo valore può essere inferiore al numero totale di cluster sul 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 alcune delle operazioni aritmetiche richieste dalla funzione GetDiskFreeSpace .
Comportamento del collegamento simbolico: se il percorso punta a un collegamento simbolico, l'operazione viene eseguita sulla 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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 (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |