通过

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 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 emptyvc.h
DLL Shell32.dll (5.0 或更高版本)