IActionProgress：：UpdateProgress 方法 (shobjidl_core.h)

  • 项目

将操作的进度汇报到 UI。

语法

HRESULT UpdateProgress(
  [in] ULONGLONG ulCompleted,
  [in] ULONGLONG ulTotal
);

参数

[in] ulCompleted

类型： ULONGLONG

已完成的操作量。

[in] ulTotal

类型： ULONGLONG

操作的总量。

返回值

类型： HRESULT

如果成功，则返回S_OK，否则返回错误值。

注解

应定期调用此方法以更新操作的进度。 实现类可能以任何所需方式解释这些值，尽管 ulCompleted 和 ulTotal 的值应相互解释，以确定有意义的进度量。 通常，需要一个百分比，在这种情况下， ulCompleted 的值应除以 ulTotal，结果乘以值 100。

要求

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