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 не обязательно препятствует быстрому завершению работы клиента.
Дополнительные сведения о процессе быстрого завершения работы см. в статье Обзор быстрого завершения работы. Сведения о том, как успешно выполнить быстрое завершение работы, см. в разделе Рекомендации по быстрому завершению работы.