Metodo IEmptyVolumeCache::Initialize (emptyvc.h)

Articolo
08/23/2023

Inizializza il gestore di pulizia del disco, in base alle informazioni archiviate nella chiave del Registro di sistema specificata.

Sintassi

HRESULT Initialize(
  [in]      HKEY    hkRegKey,
  [in]      LPCWSTR pcwszVolume,
  [out]     LPWSTR  *ppwszDisplayName,
  [out]     LPWSTR  *ppwszDescription,
  [in, out] DWORD   *pdwFlags
);

Parametri

[in] hkRegKey

Tipo: HKEY

Handle per la chiave del Registro di sistema che contiene le informazioni sull'oggetto gestore.

[in] pcwszVolume

Tipo: LPCWSTR

Puntatore a una stringa Unicode con terminazione Null con la radice del volume, ad esempio "C:".

[out] ppwszDisplayName

Tipo: LPWSTR*

Puntatore a una stringa Unicode con terminazione Null con il nome che verrà visualizzato nell'elenco dei gestori di pulizia del disco. Se non viene assegnato alcun valore, verrà usato il valore del Registro di sistema.

[out] ppwszDescription

Tipo: LPWSTR*

Puntatore a una stringa Unicode con terminazione Null che verrà visualizzata quando questo oggetto viene selezionato dall'elenco dei gestori di pulizia del disco disponibili. Se non viene assegnato alcun valore, verrà usato il valore del Registro di sistema.

[in, out] pdwFlags

Tipo: DWORD*

Flag utilizzati per passare le informazioni al gestore e tornare al gestore di pulizia del disco.

Questi flag possono essere passati all'oggetto :

EVCF_OUTOFDISKSPACE

Se questo flag è impostato, l'utente non ha spazio su disco nell'unità. Quando questo flag viene ricevuto, il gestore deve essere aggressivo per liberare spazio su disco, anche se comporta una perdita di prestazioni. Il gestore, tuttavia, non deve eliminare i file che causano un errore di un'applicazione o l'utente perde i dati.

EVCF_SETTINGSMODE

Se lo strumento di gestione pulizia del disco viene eseguito in base a una pianificazione, questo flag verrà impostato. È necessario assegnare valori ai parametri ppwszDisplayName e ppwszDescription . Se questo flag è impostato, gestione pulizia disco non chiamerà IEmptyVolumeCache::GetSpaceUsed, IEmptyVolumeCache::P urge o IEmptyVolumeCache::ShowProperties. Poiché IEmptyVolumeCache::P urge non verrà chiamato, la pulizia deve essere gestita da IEmptyVolumeCache::Initialize. Il gestore deve ignorare il parametro pcwszVolume e pulire eventuali file non necessari indipendentemente dall'unità su cui si trovano. Poiché non è possibile inviare commenti e suggerimenti degli utenti, è consigliabile toccare solo i file estremamente sicuri da pulire.

Questi flag possono essere passati dal gestore alla gestione pulizia disco:

EVCF_DONTSHOWIFZERO

Impostare questo flag quando non sono presenti file da eliminare. Quando viene chiamato IEmptyVolumeCache::GetSpaceUsed , impostare il parametro pdwSpaceUsed su zero e gestione pulizia disco ometterà il gestore dall'elenco.

EVCF_ENABLEBYDEFAULT

Impostare questo flag per fare in modo che il gestore sia selezionato per impostazione predefinita nell'elenco di Gestione pulizia. Verrà eseguito ogni volta che viene eseguita l'utilità Pulizia disco, a meno che l'utente non deseleziona la casella di controllo del gestore. Dopo aver deselezionato la casella di controllo, il gestore non verrà eseguito fino a quando l'utente non lo seleziona nuovamente.

EVCF_ENABLEBYDEFAULT_AUTO

Impostare questo flag in modo che il gestore venga eseguito automaticamente durante la pulizia pianificata. Questo flag deve essere impostato solo quando l'eliminazione dei file è a basso rischio. Come per EVCF_ENABLEBYDEFAULT, l'utente può scegliere di non eseguire il gestore deselezionando la casella di controllo nell'elenco di Gestione pulizia disco.

EVCF_HASSETTINGS

Impostare questo flag per indicare che il gestore può visualizzare un'interfaccia utente. Un esempio di interfaccia utente semplice è una casella di riepilogo che visualizza i file deletable e consente all'utente di selezionare quelli da eliminare. Gestione pulizia disco visualizzerà quindi un pulsante sotto la descrizione del gestore di pulizia. L'utente fa clic su questo pulsante per richiedere l'interfaccia utente. Il testo predefinito del pulsante è "Settings", ma il gestore può specificare un testo diverso impostando il valore AdvancedButtonText nella relativa chiave del Registro di sistema.

EVCF_REMOVEFROMLIST

Impostare questo flag per rimuovere il gestore dall'elenco di Gestione pulizia dischi. Tutte le informazioni del Registro di sistema verranno eliminate e il gestore non può essere eseguito di nuovo finché la chiave e i relativi valori non vengono ripristinati. Questo flag viene usato principalmente per le operazioni di pulizia monouso.

Valore restituito

Tipo: HRESULT

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
S_FALSE	Nessun file da eliminare.
E_ABORT	L'operazione di pulizia è stata terminata prematuramente.
E_FAIL	Operazione di pulizia non riuscita.

Commenti

Questo metodo viene usato dalla gestione pulizia dischi di Windows 98. Windows 2000 usa il metodo InitializeEx esportato da IEmptyVolumeCache2.

Usare CoTaskMemAlloc per allocare memoria per le stringhe restituite tramite ppwszDisplayName e ppwszDescription. Gestione pulizia disco libera la memoria quando non è più necessaria.

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