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


Объекты состояния MAPI

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

Объекты состояния сообщают сведения о ресурсах MAPI. Например, поставщик услуг, процесс отправки и получения MAPI или адресная книга.

Существует объект состояния, предоставляющий сведения о каждом отдельном поставщике услуг в текущем профиле. MAPI отвечает за реализацию объектов состояния для подсистемы, процесса отправки и получения MAPI и адресной книги. Объект состояния подсистемы предоставляет глобальную информацию. Объект состояния для интегрированной адресной книги предоставляет состояние всех поставщиков адресных книг, работающих в настоящее время.

Каждый объект состояния включается в таблицу состояния— таблицу, поддерживаемую MAPI, которая предоставляет клиентам все сведения о состоянии сеанса. Дополнительные сведения см. в разделе Таблицы состояния. Клиенты могут получить доступ к определенному объекту состояния либо через таблицу, либо через его объект входа в систему для поставщика услуг. Например, чтобы получить доступ к объекту состояния поставщика адресной книги, клиент может вызвать IABLogon::OpenStatusEntry. Дополнительные сведения см. в разделе IABLogon::OpenStatusEntry.

Клиенты могут использовать объекты состояния для:

  • Сведения о состоянии сеанса.

  • Мониторинг поставщика услуг.

  • Управление передачей сообщений.

  • Просмотр или изменение конфигурации и состояния ресурса.

Каждый объект состояния реализует интерфейс IMAPIStatus . Дополнительные сведения см. в разделе IMAPIStatus : IMAPIProp. Однако не каждый объект состояния полностью поддерживает каждый метод IMAPIStatus . Так как существуют различия в методах, поддерживаемых объектом состояния, клиенты должны узнать о конкретном объекте состояния, прежде чем они смогут его использовать. Объекты состояния должны публиковать сведения о своих функциях в следующих трех свойствах:

PR_RESOURCE_METHODS (PidTagResourceMethods)

PR_RESOURCE_TYPE (PidTagResourceType)

PR_RESOURCE_FLAGS (PidTagResourceFlags)

Дополнительные сведения о реализации объекта состояния см. в разделе Реализация объекта состояния. Дополнительные сведения об использовании объекта состояния см. в разделе Таблица состояния и объекты состояния.