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 の値を掛けます。

要件