IEmptyVolumeCacheCallBack::P urgeProgress-Methode (emptyvc.h)

Artikel
01/27/2024

Wird in regelmäßigen Abständen von einem Datenträgerbereinigungshandler aufgerufen, um den Datenträgerbereinigungs-Manager auf den Fortschritt einer Bereinigung von entlesbaren Dateien zu aktualisieren.

Syntax

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

Parameter

[in] dwlSpaceFreed

Typ: DWORDLONG

Die Menge des Speicherplatzes in Bytes, der an diesem Punkt der Bereinigung freigegeben wurde. Der Datenträgerbereinigungs-Manager verwendet diesen Wert, um die Statusleiste zu aktualisieren.

[in] dwlSpaceToFree

Typ: DWORDLONG

Die Menge des Speicherplatzes in Bytes, der an diesem Punkt der Bereinigung noch freigegeben werden muss.

[in] dwFlags

Art: DWORD

Ein Flag, das an den Datenträgerbereinigungs-Manager gesendet werden kann. Sie kann den folgenden Wert aufweisen:

EVCCBF_LASTNOTIFICATION

Dieses Flag sollte festgelegt werden, wenn der Handler diese Methode nicht erneut aufruft. Sie wird in der Regel festgelegt, wenn die Bereinigung kurz vor dem Abschluss steht.

[in] pcwszStatus

Typ: LPCWSTR

Reserviert.

Rückgabewert

Typ: HRESULT

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Handler sollte weiterhin deletable-Dateien bereinigen.
E_ABORT	Dieser Wert wird zurückgegeben, wenn der Benutzer im Dialogfeld des Datenträgerbereinigungs-Managers auf die Schaltfläche Abbrechen klickt, während eine Überprüfung ausgeführt wird. Der Handler sollte das Löschen von Dateien beenden und herunterfahren.

Hinweise

Diese Methode wird in der Regel von der Purge-Methode des Handlers aufgerufen, während der Handler deletable-Dateien löscht. Handler sollten PurgeProgress regelmäßig aufrufen, um den Benutzer über den Fortschritt auf dem Laufenden zu halten, insbesondere wenn die Bereinigung lange dauert. Durch häufiges Aufrufen dieser Methode kann der Handler auch sofort heruntergefahren werden, wenn ein Benutzer eine Bereinigung abbricht.

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