IReconcileInitiator::SetProgressFeedback メソッド (reconcil.h)
ブリーフケース調整者が調整の完了に向けて行った進行状況を示します。 量は分数であり、ulProgress パラメーターと ulProgressMax パラメーターの商として計算されます。 調整者は、調整プロセス中にこのメソッドを定期的に呼び出す必要があります。
構文
HRESULT SetProgressFeedback(
ULONG ulProgress,
ULONG ulProgressMax
);
パラメーター
ulProgress
種類: ULONG
進行状況の分数の分子。
ulProgressMax
種類: ULONG
進行状況分数の分母。
戻り値
型: HRESULT
成功した場合はS_OK値を返し、指定されていないエラーが発生した場合はE_UNEXPECTED値を返します。
注釈
イニシエーターは、通常、この進行状況の測定を使用して、ユーザーの温度計ゲージまたはその他の形式の視覚的フィードバックを更新します。 briefcase リコンサイルは、 ulProgressMax の値を呼び出しから呼び出しに変更できます。 つまり、このメソッドの連続した呼び出しは、必ずしも着実な前方進行を示すわけではありません。 逆方向の進歩は有効ですが、望ましくありません。 ユーザーに後方の進行状況を表示する必要があるかどうかを判断するのは、イニシエーターの責任です。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | reconcil.h |
[DLL] | Shell32.dll (バージョン 4.0 以降) |