IMAPIStatus::SettingsDialog
Область применения: Outlook 2013 | Outlook 2016
Отображает лист свойств, позволяющий пользователю изменять конфигурацию поставщика услуг. Этот метод не поддерживается в объектах состояния, реализуемых MAPI.
HRESULT SettingsDialog(
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Параметры
ulUIParam
[в] Дескриптор родительского окна страницы свойств конфигурации.
ulFlags
[в] Битовая маска флагов, управляющая отображением страницы свойств. Можно задать следующий флаг:
UI_READONLY
Предполагается, что поставщик не должен разрешать пользователям изменять свойства конфигурации. Этот флаг является только предложением; его можно игнорировать.
Возвращаемое значение
S_OK
Страница свойств конфигурации успешно отображается.
MAPI_E_NO_SUPPORT
Объект состояния не поддерживает этот метод, о чем свидетельствует отсутствие флага STATUS_SETTINGS_DIALOG в свойстве PR_RESOURCE_METHODS (PidTagResourceMethods).
Замечания
Метод IMAPIStatus::SettingsDialog отображает лист свойств конфигурации. Все поставщики услуг должны поддерживать метод SettingsDialog , но он не является обязательным. Поставщики услуг могут реализовать собственные листы свойств или использовать реализацию, указанную в методе IMAPISupport::D oConfigPropsheet объекта поддержки. DoConfigPropsheet создает лист свойств для чтения и записи.
Примечания для исполнителей
Если у удаленного поставщика транспорта есть какие-либо параметры, он должен сделать следующее:
Откройте раздел профиля поставщика транспорта.
Получение параметров свойств поставщика транспорта из профиля.
Отображение параметров свойств в диалоговом окне.
Если диалоговое окно позволяет изменять параметры свойств, проверка, что новые параметры действительны, и сохраните их обратно в разделе профиля поставщика транспорта.
Возвращает S_OK или любые значения ошибок, возвращенные на предыдущих шагах.
Примечания для вызывающих методов
Страницу свойств, отображаемую в разделе ПараметрыDialog , можно использовать для выполнения различных задач, таких как:
Укажите хранилище сообщений по умолчанию.
Укажите порядок транспорта.
Укажите контейнер адресной книги по умолчанию для просмотра.
Укажите порядок поиска для разрешения неоднозначных имен.
Укажите личную адресную книгу по умолчанию.
Поставщики услуг могут реализовывать листы свойств, доступные только для чтения и записи, или сочетание разрешений в зависимости от свойства. Поставщики услуг могут реализовывать различные разрешения для отдельных свойств, устанавливая ограничения свойств. Режим по умолчанию для листов свойств — чтение и запись. Вы можете запросить листы свойств только для чтения, задав флаг UI_READONLY в вызовах SettingsDialog. Это могут сделать поставщики служб, которые могут реализовать листы свойств только для чтения. Однако, поскольку некоторые поставщики услуг не могут переопределить режим по умолчанию, необходимо быть готовыми к обработке листов свойств любого типа.
Так как пользовательский интерфейс всегда участвует в этой операции, только интерактивные клиенты должны вызывать SettingsDialog.
См. также
IMAPISupport::DoConfigPropsheet