IActionProgress::UpdateProgress 方法 (shobjidl_core.h)

将操作的进度汇报到 UI。

语法

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

参数

[in] ulCompleted

类型: ULONGLONG

已完成的操作量。

[in] ulTotal

类型: ULONGLONG

操作的总量。

返回值

类型: HRESULT

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

注解

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

要求

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