Funzione GetDiskFreeSpaceA (fileapi.h)

  • Articolo

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

Vedere anche

Funzioni di gestione dei dischi

Getdiskfreespaceex

GetDriveType