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


IMAPIProviderShutdown : IUnknown

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

Позволяет подсистеме MAPI информировать поставщика MAPI о быстром завершении работы клиента MAPI, чтобы поставщик MAPI смог отреагировать на завершение работы.

Свойство Значение
Файл заголовка:
Mapidefs.h
Предоставляется:
Объекты поставщика: IXPProvider, IABProvider или IMSProvider
Реализовано в:
Поставщик MAPI
Вызывающая сторона:
Подсистема MAPI
Идентификатор интерфейса:
IID_IMAPIProviderShutdown
Тип указателя:
LPMAPIPROVIDERSHUTDOWN

Порядок vtable

Свойство Значение
QueryFastShutdown
Запрашивает у поставщика MAPI поддержку быстрого завершения работы.
NotifyProcessShutdown
Указывает поставщику MAPI, что клиент MAPI собирается выполнить быстрое завершение работы, чтобы поставщик смог принять меры для предотвращения потери данных.
DoFastShutdown
Указывает поставщику MAPI, что клиент MAPI немедленно завершает работу, чтобы поставщик MAPI сохранял изменения, чтобы предотвратить потерю данных.

Замечания

Быстрое завершение работы позволяет клиенту MAPI выйти из своего процесса в течение короткого времени, надеюсь, после того, как клиент и загруженные поставщики MAPI сохранили параметры и данные MAPI. Клиент MAPI всегда инициирует быстрое завершение работы и должен запрашивать поддержку быстрого завершения работы подсистемы MAPI у загруженных поставщиков MAPI. Администратор может задать реестр Windows на уровне пользователя, чтобы указать уровень поддержки поставщика, необходимый для быстрого завершения работы всех клиентов MAPI. Дополнительные сведения о параметрах реестра см. в разделе Параметры быстрого завершения работы пользователя. Однако для успешного быстрого завершения работы без потери данных поставщики MAPI должны реализовать интерфейс IMAPIProviderShutdown .

Поставщик MAPI, который должен поддерживать быстрое завершение работы клиента, должен возвращать S_OK подсистеме MAPI в методе IMAPIProviderShutdown::QueryFastShutdown . Когда подсистема MAPI впоследствии вызывает методы IMAPIProviderShutdown::NotifyProcessShutdown и IMAPIProviderShutdown::D oFastShutdown , поставщик MAPI должен предпринять необходимые действия для сохранения параметров и данных MAPI и подготовки к выходу клиента.

Поставщики MAPI, которым не требуется поддержка быстрого завершения работы клиента, должны по-прежнему реализовывать интерфейс IMAPIProviderShutdown , а метод IMAPIProviderShutdown::QueryFastShutdown возвращает MAPI_E_NO_SUPPORT. Это приводит к тому, что Outlook в качестве клиента MAPI ожидает освобождения всех внешних ссылок, прежде чем завершит работу.

В зависимости от параметра реестра Windows пользователя для быстрого завершения работы не реализация интерфейса IMAPIProviderShutdown не обязательно препятствует быстрому завершению работы клиента.

Дополнительные сведения о процессе быстрого завершения работы см. в статье Обзор быстрого завершения работы. Сведения о том, как успешно выполнить быстрое завершение работы, см. в разделе Рекомендации по быстрому завершению работы.

См. также

Интерфейсы MAPI

Завершение работы клиента в MAPI