共用方式為

IEmptyVolumeCache：:P urge 方法 (emptyvc.h)

  • 發行項

通知處理常式開始刪除其不需要的檔案。

語法

HRESULT Purge(
  [in] DWORDLONG                 dwlSpaceToFree,
  [in] IEmptyVolumeCacheCallBack *picb
);

參數

[in] dwlSpaceToFree

類型： DWORDLONG

處理常式應該釋放的磁碟空間量。 如果此參數設定為 -1，處理常式應該刪除其所有檔案。

[in] picb

類型： IEmptyVolumeCacheCallback*

磁片清理管理員 IEmptyVolumeCacheCallBack 介面的指標。 這個指標可用來呼叫介面的 PurgeProgress 方法，以報告作業進度。

傳回值

類型： HRESULT

這個方法可以傳回下列其中一個值。

傳回碼 描述
S_OK
 成功。
E_ABORT
 作業已提前結束。 當 PurgeProgress 傳回E_ABORT時，通常會傳回此值。 當使用者按一下磁片清除管理員的 [ 取消 ] 按鈕來取消作業時，通常會發生這種情況。

備註

針對 Windows 98，呼叫IEmptyVolumeCache：：GetSpaceUsed時，一律會將dwSpaceToFree參數設定為處理常式所指定的值。

一般而言，呼叫此函式時，處理常式應該保持簡單，並刪除其所有檔案。 如果只刪除部分檔案有顯著的效能優勢，處理常式應該實作 ShowProperties 方法。 呼叫時，這個方法會顯示 UI，允許使用者選取要刪除的檔案。

需求

   
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 emptyvc.h
Dll Shell32.dll (5.0 版或更新版本)