IFileOperationProgressSink::UpdateProgress メソッド (shobjidl_core.h)

合計作業量に関連して現在実行されている作業の合計量の見積もりを提供します。

構文

HRESULT UpdateProgress(
  [in] UINT iWorkTotal,
  [in] UINT iWorkSoFar
);

パラメーター

[in] iWorkTotal

型: UINT

完了する作業量の見積もり。

[in] iWorkSoFar

型: UINT

これまでに完了した iWorkTotal の部分。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

iWorkTotal と iWorkSoFar の値は、"ポイント" または実行する作業の量と完了した量の見積もりです。 これらは特定の単位で指定されていませんが、プロセス全体にかかる時間にほぼ比例する必要があります。 たとえば、1 つの小さなファイルをコピーするには 2 つのポイントと見なされ、大きなファイルは 10 ポイントと見なされる場合があります。 プロセスが 5 つの小さなファイルと 1 つの大きなファイルをコピーする操作を実行していて、そのプロセスが 4 つの小さなファイルのうち 4 つを完了した場合、 iWorkSoFar は 8 ポイント (4 x 2 = 8) になり、 iWorkTotal は 20 ポイント (5 x 2 + 10 = 20) になるため、見積もりは 8/20 ポイント (または 40%) になります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)