IFileOperationProgressSink_UpdateProgress

全作業量に対して、現在までに完了した作業量の見積もりを提供する。

IFileOperationProgressSink_UpdateProgress this, iWorkTotal, iWorkSoFar

this : [comobj] IFileOperationProgressSink インターフェースの COM オブジェクト変数
iWorkTotal : [int] 型: UINT 完了すべき作業量の見積もり。
iWorkSoFar : [int] 型: UINT iWorkTotal のうち、これまでに完了した分。

(プラグイン / モジュール : com_misc.dll)

解説

全作業量に対して、現在までに完了した作業量の見積もりを提供する。

[戻り値]
型: HRESULT このメソッドが成功した場合は S_OK を返す。そうでない場合は HRESULT エラーコードを返す。

[備考]
iWorkTotal および iWorkSoFar
の値は、完了すべき作業量と既に完了した量の「ポイント」または見積もりである。特定の単位で指定されるわけではないが、プロセス全体にかかる時間にほぼ比例するようにすべきである。例えば、小さなファイル
1 個のコピーを 2 ポイント、大きなファイルを 10 ポイントとみなすことができる。小さなファイル 5 個と大きなファイル 1
個をコピーするプロセスで、小さなファイルのうち 4 個を完了した場合、iWorkSoFar は 8 ポイント (4 × 2 =
8)、iWorkTotal は 20 ポイント (5 × 2 + 10 = 20) となり、見積もりは 20 ポイント中 8 ポイント
(40%) 完了となる。

情報