IMAPIProgress::SetLimits

適用対象: Outlook 2013 | Outlook 2016

操作内の項目数の下限と上限、および操作の進行状況情報の計算方法を制御するフラグを設定します。

HRESULT SetLimits(
  LPULONG lpulMin,
  LPULONG lpulMax,
  LPULONG lpulFlags
);

パラメーター

lpulMin

[in]操作内の項目の下限を含む変数へのポインター。

lpulMax

[in]操作内の項目の上限を含む変数へのポインター。

lpulFlags

[in]進行状況情報を計算する操作のレベルを制御するフラグのビットマスク。 次のフラグを設定できます。

MAPI_TOP_LEVEL

IMAPIProgress::P rogress メソッドの ulCount パラメーターと ulTotal パラメーターの値を使用します。これは、現在処理されている項目とアイテムの合計をそれぞれ示して、操作の進行状況をインクリメントします。 このフラグが設定されている場合は、グローバル下限と上限の値を設定する必要があります。

戻り値

S_OK

�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��B

注釈

サービス プロバイダーは IMAPIProgress::SetLimits メソッドを呼び出して、MAPI_TOP_LEVEL フラグを設定またはクリアし、ローカルおよびグローバルの最小値と最大値を設定します。 フラグ設定の値は、進行状況オブジェクトがローカルまたはグローバルの最小値と最大値を認識するかどうかに影響します。 MAPI_TOP_LEVEL フラグが設定されている場合、これらの値はグローバルと見なされ、操作全体の進行状況を計算するために使用されます。 進行状況オブジェクトは、グローバル最小値を 1 に、グローバル最大値を 1000 に初期化します。

MAPI_TOP_LEVELが設定されていない場合、最小値と最大値はローカルと見なされ、プロバイダーはそれらを内部的に使用して下位レベルのサブオブジェクトの進行状況を表示します。 進行状況オブジェクトは、IMAPIProgress::GetMin メソッドと IMAPIProgress::GetMax メソッドが呼び出されたときにプロバイダーに返すことができるように、ローカルの最小値と最大値のみを保存します。

SetLimits とその他の IMAPIProgress メソッドを実装する方法の詳細については、「進行状況インジケーターの実装」を参照してください。

進行状況オブジェクトを呼び出す方法とタイミングの詳細については、「進行状況インジケーターを表示する」を参照してください。

MFCMAPI リファレンス

MFCMAPI のサンプル コードについては、次の表を参照してください。

関連項目

IMAPIProgress::GetMaxIMAPIProgress::GetMin
IMAPIProgress::Progress
IMAPIProgress: コード サンプルとしての IUnknownMFCMAPI
進行状況インジケーターを表示する
進行状況インジケーターの実装