IFileOperationProgressSink：：UpdateProgress 方法 (shobjidl_core.h)

  • 项目

提供当前完成的工时总量相对于总工时量的估计值。

语法

HRESULT UpdateProgress(
  [in] UINT iWorkTotal,
  [in] UINT iWorkSoFar
);

参数

[in] iWorkTotal

类型： UINT

要完成的工作量的估计值。

[in] iWorkSoFar

类型： UINT

到目前为止已完成的 iWorkTotal 部分。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

iWorkTotal 和 iWorkSoFar 值是“磅”或要完成的工作量和完成量的估计值。 它们未在任何特定单位中指定，但应与整个进程花费的时间大致成正比。 例如，复制一个小文件可能被视为两个点，而一个大文件可能被视为十个点。 如果进程正在执行复制五个小文件和一个大文件的操作， 该过程已完成四个小文件， iWorkSoFar 将是 8 分 (4 x 2 = 8) 而 iWorkTotal 将是 20 分 (5 x 2 + 10 = 20) ，因此估计 (为 20 个点中的 8 个，) 完成 40%。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)