IEmptyVolumeCache::P urge-Methode (emptyvc.h)

Artikel
08/23/2023

Benachrichtigt den Handler, mit dem Löschen der nicht benötigten Dateien zu beginnen.

Syntax

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

Parameter

[in] dwlSpaceToFree

Typ: DWORDLONG

Die Menge des Speicherplatzes, den der Handler freigeben soll. Wenn dieser Parameter auf -1 festgelegt ist, sollte der Handler alle dateien löschen.

[in] picb

Typ: IEmptyVolumeCacheCallback*

Ein Zeiger auf die IEmptyVolumeCacheCallBack-Schnittstelle des Datenträgerbereinigungs-Managers. Dieser Zeiger kann verwendet werden, um die PurgeProgress-Methode der Schnittstelle aufzurufen, um den Fortschritt des Vorgangs zu melden.

Rückgabewert

Typ: HRESULT

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_ABORT	Die Operation wurde vorzeitig beendet. Dieser Wert wird normalerweise zurückgegeben, wenn PurgeProgress E_ABORT zurückgibt. Dies geschieht in der Regel, wenn der Benutzer den Vorgang abbricht, indem er auf die Schaltfläche Abbrechen des Datenträgerbereinigungs-Managers klickt.

Hinweise

Für Windows 98 wird der dwSpaceToFree-Parameter immer auf den vom Handler angegebenen Wert festgelegt, wenn IEmptyVolumeCache::GetSpaceUsed aufgerufen wurde.

Im Allgemeinen sollten Handler einfach gehalten werden und alle ihre Dateien löschen, wenn diese Funktion aufgerufen wird. Wenn es erhebliche Leistungsvorteile gibt, nur einen Teil der Dateien zu löschen, sollte der Handler die ShowProperties-Methode implementieren. Beim Aufruf zeigt diese Methode eine Benutzeroberfläche an, die es dem Benutzer ermöglicht, die zu löschenden Dateien auszuwählen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	emptyvc.h
DLL	Shell32.dll (Version 5.0 oder höher)

Freigeben über