共用方式為

IControlProgressHandler

  • 發行項

這個介面是用戶端處理常式，會在程式庫執行作業時接收更新。 然後，程式庫會執行同步回呼給指出作業進度的用戶端。 根據使用者動作，用戶端傳回碼會指示程式庫繼續作業，或取消作業。 此程式可讓 UI 向使用者顯示長時間作業的進度，例如 Save。 如果使用者選擇取消作業，UI 會將對應的程式碼傳回至程式庫。

Syntax

{
  [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

傳回作業結束時的狀態碼。

介面