通过

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，则最小值和最大值被视为本地值，提供程序在内部使用它们来显示较低级别子对象的进度。 进度对象仅保存本地最小值和最大值，以便在调用 IMAPIProgress：：GetMin 和 IMAPIProgress：：GetMax 方法时，它们可以返回到提供程序。

有关如何实现 SetLimits 和其他 IMAPIProgress 方法的详细信息，请参阅 实现进度指示器。

有关如何调用进度对象以及何时调用的详细信息，请参阅显示进度指示器。

MFCMAPI 引用

有关 MFCMAPI 示例代码，请参阅下表。

文件 函数 备注
MAPIProgress.cpp
 CMAPIProgress：：SetLimits
 MFCMAPI 使用 IMAPIProgress：：SetLimits 方法设置进度对象的最大和最小限制和标志。

另请参阅

IMAPIProgress：：GetMaxIMAPIProgress：：GetMin
IMAPIProgress::Progress
IMAPIProgress：IUnknownMFCMAPI 作为代码示例
显示进度指示器
实现进度指示器