IMAPIProgress::GetMin
Область применения: Outlook 2013 | Outlook 2016
Возвращает минимальное значение в методе IMAPIProgress::SetLimits, для которого отображается информация о ходе выполнения.
HRESULT GetMin(
ULONG FAR * lpulMin
);
Параметры
lpulMin
Указатель на минимальное количество элементов в операции [выходные данные].
Возвращаемое значение
S_OK
Получено минимальное количество элементов в операции.
Замечания
Минимальное значение представляет начало операции в числовой форме. Оно может быть глобальным максимальным значением, представляющим отображаемые данные всего хода выполнения, или локальным значением, представляющим только часть отображаемых данных.
Значение параметра флага определяет, как объект хода выполнения реагирует на минимальное значение (как на локальное или как на глобальное). Когда флаг MAPI_TOP_LEVEL задан, минимальное значение обрабатывается как глобальное и используется для определения хода выполнения всей операции. Когда флаг MAPI_TOP_LEVEL не задан, минимальное значение обрабатывается как локальное и поставщики используют его внутренним способом для отображения хода выполнения касательно подчиненных объектов нижнего уровня. Объекты хода выполнения сохраняют локальное минимальное значение, только чтобы возвратить его поставщику при вызове GetMin.
Примечания для реализующих
Инициализируйте минимальное значение, указав 1. Поставщики службы могут сбросить это значение путем вызова метода IMAPIProgress::SetLimits. Дополнительные сведения о том, как реализовать GetMin и другие методы IMAPIProgress, см. в статье Реализация индикатора хода выполнения.
Дополнительные сведения о том, как и когда выполнять вызовы объекта хода выполнения, см. в статье Отображение индикатора хода выполнения.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Примечание |
|---|---|---|
| MAPIProgress.cpp |
CMAPIProgress::GetMin |
MFCMAPI использует метод IMAPIProgress::GetMin, чтобы получить минимальное значение для индикатора хода выполнения. Возвращает 1, если ранее не были заданы ограничения путем вызова метода IMAPIProgress::SetLimits. |