IEmptyVolumeCacheCallBack::ScanProgress-Methode (emptyvc.h)

Artikel
08/23/2023

Wird von einem Datenträgerbereinigungshandler aufgerufen, um den Datenträgerbereinigungs-Manager für den Fortschritt einer Überprüfung auf entwertbare Dateien zu aktualisieren.

Syntax

HRESULT ScanProgress(
  [in] DWORDLONG dwlSpaceUsed,
  [in] DWORD     dwFlags,
  [in] LPCWSTR   pcwszStatus
);

Parameter

[in] dwlSpaceUsed

Typ: DWORDLONG

Die Menge des Speicherplatzes, den der Handler an diesem Punkt der Überprüfung freigeben kann.

[in] dwFlags

Art: DWORD

Ein Flag, das an den Datenträgerbereinigungs-Manager gesendet werden kann. Dieses Flag kann den folgenden Wert haben.

EVCCBF_LASTNOTIFICATION

Dieses Flag sollte festgelegt werden, wenn der Handler diese Methode nicht erneut aufruft. Sie wird in der Regel festgelegt, wenn die Überprüfung bald abgeschlossen ist.

[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 mit der Suche nach nicht verfügbaren Dateien fortfahren.
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 den Scanvorgang beenden und herunterfahren.

Hinweise

Diese Methode wird in der Regel von der GetSpaceUsed-Methode des Handlers aufgerufen, während der Handler nach entwertbaren Dateien sucht.

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)