IMAPIProgress::GetMin
適用於:Outlook 2013 |Outlook 2016
傳回 IMAPIProgress::SetLimits 方法中顯示進度資訊的最小值。
HRESULT GetMin(
ULONG FAR * lpulMin
);
參數
lpulMin
[out]作業中項目數目下限的指標。
傳回值
S_OK
已擷取作業中的項目數目下限。
註解
最小值代表以數值形式開始的作業。 此值可以是全域最大值,用來代表整個進度顯示的範圍,或是本機值,用來只代表顯示的一部分。
旗標設定的值會影響進度物件是否瞭解要為本機或全域的最小值。 設定MAPI_TOP_LEVEL旗標時,最小值會被視為全域值,並用來計算整個作業的進度。 未設定MAPI_TOP_LEVEL時,最小值會視為本機值,而提供者會在內部使用它來顯示較低層級子對象的進度。 Progress 物件只會儲存本機最小值,以便透過 GetMin 呼叫將它傳回給提供者。
實作者注意事項
將最小值初始化為1。 服務提供者可以呼叫 IMAPIProgress::SetLimits 方法來重設此值。 如需如何實作 GetMin 和其他 IMAPIProgress 方法的詳細資訊,請參閱 實作進度指示器。
如需如何及何時呼叫進度對象的詳細資訊,請參閱 顯示進度指示器。
MFCMAPI 參考
如需 MFCMAPI 範例程式代碼,請參閱下表。
檔案 | Function | Comment |
---|---|---|
MAPIProgress.cpp |
CMAPIProgress::GetMin |
MFCMAPI 使用 IMAPIProgress::GetMin 方法來取得進度指標的最小值。 除非先前已藉由呼叫 IMAPIProgress::SetLimits 方法來設定限制,否則傳回 1。 |