IFileOperationProgressSink::UpdateProgress 方法 (shobjidl_core.h)

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

语法

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

参数

[in] iWorkTotal

类型: UINT

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

[in] iWorkSoFar

类型: UINT

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

返回值

类型: HRESULT

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

注解

iWorkTotaliWorkSoFar 值是“磅”或要完成的工作量和完成量的估计值。 它们未在任何特定单位中指定,但应与整个进程花费的时间大致成正比。 例如,复制一个小文件可能被视为两个点,而一个大文件可能被视为十个点。 如果进程正在执行复制五个小文件和一个大文件的操作, 该过程已完成四个小文件, 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)