IEmptyVolumeCacheCallBack::P urgeProgress メソッド (emptyvc.h)

削除可能なファイルの消去の進行状況に関するディスク クリーンアップ マネージャーを更新するために、ディスク クリーンアップ ハンドラーによって定期的に呼び出されます。

構文

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

パラメーター

[in] dwlSpaceFreed

種類: DWORDLONG

消去のこの時点で解放されたディスク領域の量 (バイト単位)。 ディスク クリーンアップ マネージャーは、この値を使用して進行状況バーを更新します。

[in] dwlSpaceToFree

種類: DWORDLONG

消去のこの時点で解放されたままのディスク領域 (バイト単位)。

[in] dwFlags

型: DWORD

ディスク クリーンアップ マネージャーに送信できるフラグ。 次の値を指定できます。

EVCCBF_LASTNOTIFICATION

ハンドラーがこのメソッドを再度呼び出さない場合は、このフラグを設定する必要があります。 通常、消去が完了しそうになったときに設定されます。

[in] pcwszStatus

種類: LPCWSTR

予約済み。

戻り値

種類: HRESULT

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード	説明
S_OK	ハンドラーは、削除可能なファイルの消去を続行する必要があります。
E_ABORT	この値は、スキャンの実行中にユーザーがディスク クリーンアップ マネージャーのダイアログ ボックスの [キャンセル ] ボタンをクリックすると返されます。 ハンドラーはファイルの消去を停止し、シャットダウンする必要があります。

注釈

このメソッドは通常、ハンドラーが削除可能なファイルを消去している間に、ハンドラーの Purge メソッドによって呼び出されます。 ハンドラーは PurgeProgress を 定期的に呼び出して、特に消去に時間がかかる場合に、進行状況をユーザーに通知する必要があります。 このメソッドを頻繁に呼び出すと、ユーザーが消去を取り消した場合にハンドラーをすぐにシャットダウンすることもできます。

要件

サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	emptyvc.h
[DLL]	Shell32.dll (バージョン 5.0 以降)