Metodo IEmptyVolumeCache::GetSpaceUsed (emptyvc.h)

Articolo
08/23/2023

Richiede la quantità di spazio su disco che il gestore di pulizia del disco può liberare.

Sintassi

HRESULT GetSpaceUsed(
  [out] DWORDLONG                 *pdwlSpaceUsed,
  [in]  IEmptyVolumeCacheCallBack *picb
);

Parametri

[out] pdwlSpaceUsed

Tipo: DWORDLONG*

Quantità di spazio su disco, in byte, che il gestore può liberare. Questo valore verrà visualizzato nell'elenco di Gestione pulizia disco, a destra della casella di controllo del gestore. Per indicare che non si sa quanto spazio su disco può essere liberato, impostare questo parametro su -1 e "??? Verrà visualizzato MB". Se si imposta il flag di EVCF_DONTSHOWIFZERO quando è stato chiamato Initialize , l'impostazione di pdwSpaceUsed su zero invierà una notifica al gestore di pulizia del disco per omettere il gestore dall'elenco.

[in] picb

Tipo: IEmptyVolumeCacheCallback*

Puntatore all'interfaccia IEmptyVolumeCacheCallback del gestore pulizia disco. Questo puntatore può essere usato per chiamare il metodo ScanProgress dell'interfaccia per segnalare lo stato di avanzamento dell'operazione.

Valore restituito

Tipo: HRESULT

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
S_FALSE	Si è verificato un errore quando il gestore ha tentato di calcolare la quantità di spazio su disco che potrebbe essere liberata.
E_ABORT	L'operazione di analisi è stata terminata prematuramente. Questo valore viene in genere restituito quando una chiamata a ScanProgress restituisce E_ABORT. Questo valore restituito indica che l'utente ha annullato l'operazione facendo clic sul pulsante Annulla di Gestione pulizia disco.

Commenti

Quando questo metodo viene chiamato da Gestione pulizia disco, il gestore deve avviare l'analisi dei file per determinare quale di essi può essere eliminato e quanto spazio su disco verrà liberato. I gestori devono chiamare periodicamente IEmptyVolumeCache::ScanProgress per mantenere l'utente informato dello stato di avanzamento dell'analisi, soprattutto se richiederà molto tempo. La chiamata a questo metodo consente spesso al gestore di determinare se l'utente ha annullato l'operazione. Se ScanProgress restituisce E_ABORT, l'utente ha annullato l'analisi. Il gestore deve interrompere immediatamente l'analisi e restituire E_ABORT.

È consigliabile impostare il parametro pdwSpaceUsed solo su -1 come ultima risorsa. Il gestore è di valore limitato a un utente se non sa quanto spazio verrà liberato.

Requisiti

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	Windows
Intestazione	emptyvc.h
DLL	Shell32.dll (versione 5.0 o successiva)

Condividi tramite