IMAPIProgress::GetMin
適用対象: Outlook 2013 | Outlook 2016
進行状況の情報が表示される IMAPIProgress::SetLimits メソッドの最小値を返します。
HRESULT GetMin(
ULONG FAR * lpulMin
);
パラメーター
lpulMin
[out] 操作中のアイテムの最小数へのポインターです。
戻り値
S_OK
操作中のアイテムの最小数が取得されました。
備考
最小値は、操作の開始を数値形式で表します。 値は、進行状況の表示全体の範囲を示すために使用されるグローバルな最大値、あるいは表示の一部のみを示すのに使用されるローカル値になります。
フラグ設定の値は、進行状況オブジェクトが最小値をローカルまたはグローバルと識別するかに影響します。 MAPI_TOP_LEVEL フラグが設定されている場合、最小値はグルーバルと見なされ、操作全体の進行状況の計算に使用されます。 MAPI_TOP_LEVEL が設定されている場合は、最小値はローカルと見なされます。プロバイダーは、この値を内部で使用して下位レベルのサブオブジェクトの進行状況を表示します。 ローカルの最小値は進行状況オブジェクトによって保存されますが、この最小値は GetMin 呼び出しを介してのみプロバイダーに返されます。
実装者へのメモ
最小値を 1 に初期化します。 サービス プロバイダーは、IMAPIProgress::SetLimits メソッドを呼び出してこの値をリセットできます。 GetMin および IMAPIProgress メソッドの実装方法の詳細については、「進行状況インジケーターの実装」を参照してください。
進行状況オブジェクトを呼び出す方法とタイミングの詳細については、「進行状況インジケーターを表示する」を参照してください。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| MAPIProgress.cpp |
CMAPIProgress::GetMin |
MFCMAPI は、IMAPIProgress::GetMin メソッドを使用して進行状況インジケーターの最小値を取得します。 制限が設定済みである場合を除き、IMAPIProgress::SetLimits メソッドを呼び出して 1 を返します。 |