IMAPIProgress : IUnknown
Область применения: Outlook 2013 | Outlook 2016
Реализует объект хода выполнения, предоставляющий клиентским приложениям индикатор хода выполнения. Индикатор хода выполнения — это отображение пользовательского интерфейса, показывающее процент завершения операции, например копирование папок между хранилищами сообщений. MAPI и клиентские приложения реализуют объекты хода выполнения, а поставщики служб используют их.
| Свойство | Значение |
|---|---|
| Файл заголовка: |
Mapidefs.h |
| Предоставляется: |
Объекты хода выполнения |
| Реализовано в: |
MAPI и клиентские приложения |
| Вызывающая сторона: |
Поставщики служб |
| Идентификатор интерфейса: |
IID_IMAPIProgress |
| Тип указателя: |
LPMAPIPROGRESS |
Порядок vtable
| Member | Описание |
|---|---|
|
Progress |
Обновления индикатор хода выполнения с отображением хода выполнения операции. |
|
GetFlags |
Возвращает параметры флага из объекта progress для уровня операции, на котором вычисляются сведения о ходе выполнения. |
|
GetMax |
Возвращает максимальное количество элементов в операции, для которой отображаются сведения о ходе выполнения. |
|
GetMin |
Возвращает минимальное значение в методе SetLimits , для которого отображаются сведения о ходе выполнения. |
|
SetLimits |
Задает нижние и верхние пределы для количества элементов в операции, а также флаги, управляющие способом вычисления сведений о ходе выполнения операции. |
Замечания
MAPI включает параметр lpProgress во многих методах, выполняющих потенциально длительные операции. lpProgress указывает на клиентную реализацию объекта выполнения. Клиенты, реализующие интерфейс IMAPIProgress , задают этот параметр, чтобы указать на их реализацию; клиенты, которые не реализуют IMAPIProgress , устанавливают для параметра значение NULL. Для отображения индикатора хода выполнения во время обработки операции поставщики услуг используют объект progress, предоставленный клиентом, если он доступен, или реализацию MAPI (указывается, если lpProgress имеет значение NULL).
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файлы | Function | Comment |
|---|---|---|
| MapiProgress.h и MapiProgress.cpp |
Неприменимо |
Если параметр IMAPIProgress включен, MFCMAPI передает реализацию IMAPIProgress всем функциям, которые вызывает MFCMAPI, которые принимают реализацию. |