共用方式為

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 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 emptyvc.h
Dll Shell32.dll (5.0 版或更新版本)