共用方式為

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

呼叫成功，並傳回預期的值。

註解

服務提供者會呼叫 IMAPIProgress：：SetLimits 方法來設定或清除MAPI_TOP_LEVEL旗標，以及設定本機和全域最小值和最大值。 旗標設定的值會影響進度物件是否瞭解要是本機或全域的最小值和最大值。 設定MAPI_TOP_LEVEL旗標時，這些值會被視為全域值，並用來計算整個作業的進度。 Progress 物件會將全域最小值初始化為 1，並將全域最大值初始化為 1000。

未設定MAPI_TOP_LEVEL時，最小值和最大值會視為本機值，而提供者會在內部使用它們來顯示較低層級子對象的進度。 Progress 物件只會儲存本機最小值和最大值，以便在呼叫 IMAPIProgress：：GetMin 和 IMAPIProgress：：GetMax 方法時，將它們傳回給提供者。

如需如何實作 SetLimits 和其他 IMAPIProgress 方法的詳細資訊，請參閱 實作進度指示器。

如需如何及何時呼叫進度對象的詳細資訊，請參閱 顯示進度指示器。

MFCMAPI 參考

如需 MFCMAPI 範例程式代碼，請參閱下表。

檔案 Function Comment
MAPIProgress.cpp
 CMAPIProgress：：SetLimits
 MFCMAPI 使用 IMAPIProgress：：SetLimits 方法來設定進度物件的最大和最小限制和旗標。

另請參閱

IMAPIProgress：：GetMaxIMAPIProgress：：GetMin
IMAPIProgress：:P rogress
IMAPIProgress：IUnknownMFCMAPI 作為程式碼範例
顯示進度指標
實作進度指標