Funzione GetDiskFreeSpaceA (fileapi.h)

Articolo
11/20/2024

Recupera informazioni sul disco specificato, inclusa la quantità di spazio libero 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 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

La funzione GetDiskFreeSpaceEx consente di evitare alcuni degli aritmetici richiesti 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [app desktop \| App UWP]
server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	fileapi.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

Funzioni di gestione disco

GetDiskFreeSpaceEx

GetDriveType

Condividi tramite