Metodo IEmptyVolumeCache::P urge (emptyvc.h)

Articolo
08/23/2023

Notifica al gestore di avviare l'eliminazione dei file non necessari.

Sintassi

HRESULT Purge(
  [in] DWORDLONG                 dwlSpaceToFree,
  [in] IEmptyVolumeCacheCallBack *picb
);

Parametri

[in] dwlSpaceToFree

Tipo: DWORDLONG

Quantità di spazio su disco che il gestore deve liberare. Se questo parametro è impostato su -1, il gestore deve eliminare tutti i file.

[in] picb

Tipo: IEmptyVolumeCacheCallback*

Puntatore all'interfaccia IEmptyVolumeCacheCallBack del gestore pulizia dischi. Questo puntatore può essere usato per chiamare il metodo PurgeProgress 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.
E_ABORT	L'operazione è stata terminata prematuramente. Questo valore viene in genere restituito quando PurgeProgress restituisce E_ABORT. Questo avviene in genere quando l'utente annulla l'operazione facendo clic sul pulsante Annulla del gestore pulizia dischi.

Commenti

Per Windows 98, il parametro dwSpaceToFree è sempre impostato sul valore specificato dal gestore quando è stato chiamato IEmptyVolumeCache::GetSpaceUsed .

In generale, i gestori devono essere mantenuti semplici ed eliminare tutti i file quando questa funzione viene chiamata. Se sono presenti vantaggi significativi per le prestazioni solo per eliminare una parte dei file, il gestore deve implementare il metodo ShowProperties . Quando viene chiamato, questo metodo visualizza un'interfaccia utente che consente all'utente di selezionare i file da eliminare.

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