IMAPIProgress::GetMax

适用于:Outlook 2013 | Outlook 2016

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

HRESULT GetMax(
  ULONG FAR * lpulMax
);

参数

lpulMax

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

返回值

S_OK

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

说明

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

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

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

针对实现者的说明

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

MFCMAPI 引用

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

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

另请参阅

IMAPIProgress::GetMin

IMAPIProgress::Progress

IMAPIProgress::SetLimits

IMAPIProgress : IUnknown

MFCMAPI 代码示例

显示进度指示器

实现进度指示器