IEmptyVolumeCache::GetSpaceUsed-Methode (emptyvc.h)

Fordert den Speicherplatz an, den der Datenträgerbereinigungshandler freigeben kann.

Syntax

HRESULT GetSpaceUsed(
  [out] DWORDLONG                 *pdwlSpaceUsed,
  [in]  IEmptyVolumeCacheCallBack *picb
);

Parameter

[out] pdwlSpaceUsed

Typ: DWORDLONG*

Die Menge des Speicherplatzes (in Bytes), den der Handler freigeben kann. Dieser Wert wird in der Liste des Datenträgerbereinigungs-Managers rechts neben dem Kontrollkästchen des Handlers angezeigt. Um anzugeben, dass Sie nicht wissen, wie viel Speicherplatz freigegeben werden kann, legen Sie diesen Parameter auf -1 und "??? MB" wird angezeigt. Wenn Sie das EVCF_DONTSHOWIFZERO-Flag festlegen, wenn Initialize aufgerufen wurde, benachrichtigt das Festlegen von pdwSpaceUsed auf Null den Datenträgerbereinigungs-Manager, um den Handler aus seiner Liste wegzulassen.

[in] picb

Typ: IEmptyVolumeCacheCallback*

Ein Zeiger auf die IEmptyVolumeCacheCallback-Schnittstelle des Datenträgerbereinigungs-Managers. Mit diesem Zeiger kann die ScanProgress-Methode dieser Schnittstelle aufgerufen werden, 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.
S_FALSE	Ein Fehler ist aufgetreten, als der Handler versucht hat, die Menge des Speicherplatzes zu berechnen, der freigegeben werden konnte.
E_ABORT	Der Scanvorgang wurde vorzeitig beendet. Dieser Wert wird normalerweise zurückgegeben, wenn ein Aufruf von ScanProgress E_ABORT zurückgibt. Dieser Rückgabewert gibt an, dass der Benutzer den Vorgang abgebrochen hat, indem er auf die Schaltfläche Abbrechen des Datenträgerbereinigungs-Managers geklickt hat.

Hinweise

Wenn diese Methode vom Datenträgerbereinigungs-Manager aufgerufen wird, sollte der Handler mit der Überprüfung seiner Dateien beginnen, um zu bestimmen, welche von ihnen gelöscht werden kann und wie viel Speicherplatz freigegeben wird. Handler sollten IEmptyVolumeCache::ScanProgress in regelmäßigen Abständen aufrufen, um den Benutzer über den Fortschritt der Überprüfung auf dem Laufenden zu halten, insbesondere wenn dies lange dauern wird. Durch häufiges Aufrufen dieser Methode kann der Handler außerdem bestimmen, ob der Benutzer den Vorgang abgebrochen hat. Wenn ScanProgress E_ABORT zurückgibt, hat der Benutzer den Scan abgebrochen. Der Handler sollte die Überprüfung sofort beenden und E_ABORT zurückgeben.

Sie sollten nur den pdwSpaceUsed-Parameter auf -1 als letztes Mittel festlegen. Der Handler ist für einen Benutzer von begrenztem Wert, wenn er nicht weiß, wie viel Speicherplatz freigegeben wird.

Anforderungen

Anforderung	Wert
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)