共用方式為

IEmptyVolumeCache：：GetSpaceUsed 方法 (emptyvc.h)

  • 發行項

要求磁碟清除處理程式可以釋放的磁碟空間量。

語法

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

參數

[out] pdwlSpaceUsed

類型： DWORDLONG*

處理程式可以釋放的磁碟空間量，以位元組為單位。 此值會顯示在磁碟清除管理員清單的處理程序複選框右邊。 若要指出您不知道可以釋放多少磁碟空間，請將此參數設定為 -1，並將 “???將會顯示 MB。 如果您在呼叫 Initialize 時設定EVCF_DONTSHOWIFZERO旗標，將 pdwSpaceUsed 設定為零會通知磁碟清除管理員從其清單中省略處理程式。

[in] picb

類型： IEmptyVolumeCacheCallback*

磁碟清除管理員 IEmptyVolumeCacheCallback 介面的指標。 這個指標可用來呼叫該介面的 ScanProgress 方法，以報告作業進度。

傳回值

類型： HRESULT

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

傳回碼 描述
S_OK
 成功。
S_FALSE
 當處理程式嘗試計算可釋放的磁碟空間量時，就會發生錯誤。
E_ABORT
 掃描作業已提前結束。 呼叫 ScanProgress 傳回E_ABORT時，通常會傳回此值。 這個傳回值表示使用者按兩下磁碟清除管理員的 [ 取消 ] 按鈕來取消作業。

備註

當磁碟清除管理員呼叫這個方法時，處理程式應該開始掃描其檔案，以判斷可以刪除哪些檔案，以及釋放多少磁碟空間。 處理程式應該定期呼叫 IEmptyVolumeCache：：ScanProgress ，讓使用者知道掃描進度，特別是需要很長的時間。 經常呼叫這個方法也可讓處理程序判斷使用者是否已取消作業。 如果 ScanProgress 傳 回E_ABORT，則使用者已取消掃描。 處理程式應該會立即停止掃描並傳回E_ABORT。

您應該只將 pdwSpaceUsed 參數設定為 -1 做為最後手段。 如果使用者不知道要釋放多少空間，處理程式的值有限。

規格需求

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