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 方法的 ulCountulTotal 参数中的值,分别指示当前处理的项和总项,以递增操作进度。 设置此标志时,必须设置全局下限和上限的值。

返回值

S_OK

调用成功,并返回了预期值或值。

注解

服务提供商调用 IMAPIProgress::SetLimits 方法来设置或清除MAPI_TOP_LEVEL标志,并设置本地和全局最小值和最大值。 标志设置的值会影响进度对象是否理解最小值和最大值是本地值还是全局值。 设置MAPI_TOP_LEVEL标志时,这些值被视为全局值,用于计算整个操作的进度。 进度对象将全局最小值初始化为 1,将全局最大值初始化为 1000。

如果未设置MAPI_TOP_LEVEL,则最小值和最大值被视为本地值,并且提供程序在内部使用它们来显示较低级别子对象的进度。 进度对象仅保存本地最小值和最大值,以便在调用 IMAPIProgress::GetMinIMAPIProgress::GetMax 方法时返回给提供程序。

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

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

MFCMAPI 引用

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

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

另请参阅

IMAPIProgress::GetMax IMAPIProgress::GetMin
IMAPIProgress::Progress
IMAPIProgress : IUnknown 作为代码示例的 MFCMAPI
显示进度指示器
实现进度指示器