IMAPIProgress::SetLimits

Статья
04/04/2023

Область применения: Outlook 2013 | Outlook 2016

Задает нижние и верхние пределы для количества элементов в операции, а также флаги, управляющие способом вычисления сведений о ходе выполнения операции.

HRESULT SetLimits(
  LPULONG lpulMin,
  LPULONG lpulMax,
  LPULONG lpulFlags
);

Параметры

lpulMin

[в] Указатель на переменную, содержащую нижний предел элементов в операции.

lpulMax

[в] Указатель на переменную, содержащую верхний предел элементов в операции.

lpulFlags

[в] Битовая маска флагов, управляющая уровнем операции, по которой вычисляются сведения о ходе выполнения. Можно задать следующий флаг:

MAPI_TOP_LEVEL

Использует значения в параметрах ulCount и ulTotal метода IMAPIProgress::P rogress, которые указывают на обрабатываемый элемент и общее количество элементов соответственно для увеличения хода выполнения операции. Если этот флаг установлен, необходимо задать значения глобальных нижних и верхних границ.

Возвращаемое значение

S_OK

�� .

Замечания

Поставщики услуг вызывают метод IMAPIProgress::SetLimits , чтобы задать или очистить флаг MAPI_TOP_LEVEL, а также задать локальные и глобальные минимальные и максимальные значения. Значение параметра флага влияет на то, понимает ли объект выполнения минимальное и максимальное значения, которые должны быть локальными или глобальными. Если установлен флаг MAPI_TOP_LEVEL, эти значения считаются глобальными и используются для вычисления хода выполнения всей операции. Объекты хода выполнения инициализируют глобальное минимальное значение 1, а глобальное максимальное значение — 1000.

Если MAPI_TOP_LEVEL не задано, минимальное и максимальное значения считаются локальными, а поставщики используют их для отображения хода выполнения для подобъектов более низкого уровня. Объекты выполнения сохраняют локальные минимальные и максимальные значения только для того, чтобы их можно было вернуть поставщикам при вызове методов IMAPIProgress::GetMin и IMAPIProgress::GetMax .

Дополнительные сведения о реализации SetLimits и других методов IMAPIProgress см. в разделе Реализация индикатора хода выполнения.

Дополнительные сведения о том, как и когда выполнять вызовы объекта хода выполнения, см. в статье Отображение индикатора хода выполнения.

Справочные материалы по MFCMAPI

Пример кода MFCMAPI указан в приведенной ниже таблице.

Файл	Функция	Примечание
MAPIProgress.cpp	CMAPIProgress::SetLimits	MFCMAPI использует метод IMAPIProgress::SetLimits для задания максимальных и минимальных ограничений и флагов для объекта progress.

См. также

IMAPIProgress::GetMax IMAPIProgress::GetMin
IMAPIProgress::Progress
IMAPIProgress: IUnknown MFCMAPI как пример кода
Отображение индикатора хода выполнения
Реализация индикатора хода выполнения

Поделиться через