IControlProgressHandler

此接口是在库执行操作时接收更新的客户端处理程序。 然后,库对客户端执行同步回调,以指示操作的进度。 根据用户操作,客户端返回代码指示库继续操作或取消操作。 此过程使 UI 能够向用户显示长操作(如“保存”)的进度。 如果用户选择取消操作,UI 会向库返回相应的代码。

语法

{
  [id(1), helpstring("OnBegin")] HRESULT OnBegin();
  [id(2), helpstring("OnUpdate")] HRESULT OnUpdate
    ([in] ULONG CurrentValuePercent);
  [id(3), helpstring("OnEnd")] HRESULT OnEnd
    ([in] HRESULT hrResult);
};

函数

下表描述了该接口提供的功能。

函数 说明

OnBegin

指示库开始操作。

OnUpdate

指示库继续执行操作。

OnEnd

操作结束后返回状态代码。

接口