IMAPIProgress::GetMax

适用于:Outlook 2013 | Outlook 2016

返回操作中显示进度信息的最大项数。

HRESULT GetMax(
  ULONG FAR * lpulMax
);

参数

lpulMax

[out]指向操作中最大项数的指针。

返回值

S_OK

已检索操作中的最大项数。

备注

最大值以数值形式表示运算的结束。 该值可以是全局最大值,用于表示整个进度显示的范围,也可以是本地值,用于仅表示显示的一部分。

标志设置的值会影响进度对象将最大值理解为本地值还是全局值。 设置MAPI_TOP_LEVEL标志后,最大值被视为全局值,用于计算整个操作的进度。 如果未设置MAPI_TOP_LEVEL,则最大值被视为本地值,提供程序在内部使用它来显示较低级别子对象的进度。 进度对象仅保存本地最大值,以便通过 GetMax 调用将其返回到提供程序。

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

针对实现者的说明

将最大值初始化为 1000。 服务提供程序可以通过调用 IMAPIProgress::SetLimits 方法重置此值。 有关如何实现 GetMax 和其他 IMAPIProgress 方法的详细信息,请参阅 实现进度指示器

MFCMAPI 引用

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

文件 函数 备注
MAPIProgress.cpp
CMAPIProgress::GetMax
MFCMAPI 使用 IMAPIProgress::GetMax 方法获取进度对象的最大值。 返回 1000,除非以前使用 IMAPIProgress::SetLimits 方法设置了限制。

另请参阅

IMAPIProgress::GetMin

IMAPIProgress::Progress

IMAPIProgress::SetLimits

IMAPIProgress : IUnknown

MFCMAPI 代码示例

显示进度指示器

实现进度指示器