Funzione SHGetDiskFreeSpaceExA (shellapi.h)
Recupera le informazioni sullo spazio su disco per un volume su disco.
Sintassi
BOOL SHGetDiskFreeSpaceExA(
[in] LPCSTR pszDirectoryName,
[out, optional] ULARGE_INTEGER *pulFreeBytesAvailableToCaller,
[out, optional] ULARGE_INTEGER *pulTotalNumberOfBytes,
[out, optional] ULARGE_INTEGER *pulTotalNumberOfFreeBytes
);
Parametri
[in] pszDirectoryName
Tipo: LPCTSTR
Stringa con terminazione Null che specifica il volume per il quale vengono recuperate le informazioni sulle dimensioni. Può trattarsi di una lettera di unità, un nome UNC o il percorso di una cartella. Non è possibile utilizzare NULL per rappresentare l'unità corrente.
[out, optional] pulFreeBytesAvailableToCaller
Tipo: ULARGE_INTEGER*
Puntatore a un valore che riceve il numero di byte nel volume disponibile per l'applicazione chiamante. Se il sistema operativo implementa quote per utente, questo valore può essere inferiore al numero totale di byte liberi nel volume.
[out, optional] pulTotalNumberOfBytes
Tipo: ULARGE_INTEGER*
Puntatore a un valore che riceve le dimensioni totali del volume, in byte.
[out, optional] pulTotalNumberOfFreeBytes
Tipo: ULARGE_INTEGER*
Puntatore a un valore che riceve il numero di byte di spazio disponibile nel volume.
Valore restituito
Tipo: bool
Restituisce true se ha esito positivo, FALSE in caso contrario.
Osservazioni
La funzione denominata in modo analogo SHGetDiskFreeSpace è semplicemente un alias per SHGetDiskFreeSpaceEx. Quando si chiama SHGetDiskFreeSpace si chiama effettivamente questa funzione.
Questa funzione chiama la funzione GetDiskFreeSpaceEx se disponibile nel sistema operativo. Se GetDiskFreeSpaceEx non è disponibile, viene emulato chiamando la funzione GetDiskFreeSpace e modificando i valori restituiti. Per altre informazioni, vedere la documentazione per GetDiskFreeSpaceEx.
Nota
L'intestazione shellapi.h definisce SHGetDiskFreeSpaceEx 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 2000 Professional, Windows XP [solo app desktop] |
| server minimo supportato | Windows Server 2003 [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
shellapi.h |
| libreria |
Shell32.lib |
| dll | Shell32.dll (versione 5.0 o successiva) |