Проверка конфигурации поставщика службы
Область применения: Outlook 2013 | Outlook 2016
Метод входа (IABProvider::Logon, IMSProvider::Logon или IXPProvider::TransportLogon) должен проверить конфигурацию поставщика. Это включает проверку правильности установки всех свойств, необходимых для полной работы. Для каждого поставщика требуется разное количество свойств; конфигурация зависит от поставщика и степени разрешенного взаимодействия с пользователем. Некоторые поставщики услуг сохраняют все необходимые свойства в профиле.
Другие поставщики услуг сохраняют частичный набор свойств в профиле и запрашивают у пользователя отсутствующие значения. Однако другие поставщики вообще не хранят свойства в профиле, полагаясь на то, что пользователь предоставляет всю информацию, необходимую для настройки.
Получение свойств, хранящихся в профиле
Вызовите IMAPISupport::OpenProfileSection, передав mapIUID поставщика в качестве входного параметра.
Вызовите методы IMAPIProp::GetProps или IMAPIProp::GetPropList раздела профиля, чтобы получить отдельные свойства или список свойств.
Задание свойств из сведений о пользователе
Отображение страницы свойств, если MAPI не установил флаг, запрещающий отображение. Следующие флаги указывают на то, что пользовательский интерфейс не может быть представлен.
| Флаг | Поставщик услуг |
|---|---|
| AB_NO_DIALOG |
Поставщик адресной книги |
| LOGON_NO_DIALOG |
Поставщик транспорта |
| MDB_NO_DIALOG |
Поставщик хранилища сообщений |
Если поставщик не сохраняет все свойства конфигурации в профиле, требуя взаимодействия с пользователем, и MAPI передает один из флагов подавления диалогового окна методу входа, верните MAPI_E_UNCONFIGURED. Также возвращается эта ошибка, если флаг подавления диалога не задан, но пользователь не предоставляет все необходимые сведения.
Если поставщик услуг завершается сбоем метода входа с MAPI_E_UNCONFIGURED, MAPI снова вызывает функцию точки входа. Если информация не может быть найдена при втором вызове, сеанс может завершиться в зависимости от того, насколько важен поставщик услуг.
На следующем рисунке показана логика, необходимая для настройки в методе входа поставщика услуг.
Блок-схема проверки конфигурации
