通过

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 或更高版本)