Metodo IEmptyVolumeCacheCallBack::P urgeProgress (emptyvc.h)

Articolo
08/23/2023

Chiamato periodicamente da un gestore di pulizia del disco per aggiornare il gestore di pulizia del disco sullo stato di avanzamento di un'eliminazione dei file deletable.

Sintassi

HRESULT PurgeProgress(
  [in] DWORDLONG dwlSpaceFreed,
  [in] DWORDLONG dwlSpaceToFree,
  [in] DWORD     dwFlags,
  [in] LPCWSTR   pcwszStatus
);

Parametri

[in] dwlSpaceFreed

Tipo: DWORDLONG

Quantità di spazio su disco, in byte, liberata a questo punto nell'eliminazione. Gestione pulizia dischi usa questo valore per aggiornare la barra di stato.

[in] dwlSpaceToFree

Tipo: DWORDLONG

Quantità di spazio su disco, in byte, che rimane liberata a questo punto nella cancellazione.

[in] dwFlags

Tipo: DWORD

Flag che può essere inviato alla gestione pulizia dischi. Può avere il valore seguente:

EVCCBF_LASTNOTIFICATION

Questo flag deve essere impostato se il gestore non chiamerà di nuovo questo metodo. Viene in genere impostato quando l'eliminazione è quasi completata.

[in] pcwszStatus

Tipo: LPCWSTR

Riservato.

Valore restituito

Tipo: HRESULT

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il gestore deve continuare a eliminare i file deletable.
E_ABORT	Questo valore viene restituito quando l'utente fa clic sul pulsante Annulla nella finestra di dialogo di Gestione pulizia dischi mentre è in corso un'analisi. Il gestore deve arrestare l'eliminazione dei file e arrestarlo.

Commenti

Questo metodo viene in genere chiamato dal metodo Di eliminazione del gestore mentre il gestore elimina i file deletable. I gestori devono chiamare periodicamente PurgeProgress per mantenere l'utente informato dello stato di avanzamento, soprattutto se l'eliminazione richiederà molto tempo. La chiamata a questo metodo consente anche al gestore di arrestare tempestivamente se un utente annulla un'eliminazione.

Requisiti


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