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

IProviderAdmin::CreateProvider

  • Статья

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

Добавляет поставщика услуг в службу сообщений.

HRESULT CreateProvider(
  LPSTR lpszProvider,
  ULONG cValues,
  LPSPropValue lpProps,
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  MAPIUID FAR * lpUID
);

Параметры

lpszProvider

[в] Указатель на имя добавляемого поставщика.

cValues

[в] Количество значений свойств, на которые указывает параметр lpProps .

lpProps

[в] Указатель на массив значений свойств, описывающий свойства добавляемого поставщика.

ulUIParam

[в] Дескриптор родительского окна любых диалоговых окон или окон, отображаемых этим методом. Параметр ulUIParam используется, если флаг MAPI_DIALOG задан в параметре ulFlags .

ulFlags

[в] Битовая маска флагов, управляющая добавлением поставщика. Можно задать следующие флаги:

  • MAPI_DIALOG: отображает диалоговое окно с запросом сведений о конфигурации.

  • MAPI_UNICODE: имя поставщика и свойства строки имеют формат Юникода. Если флаг MAPI_UNICODE не задан, эти строки имеют формат ANSI.

lpUID

[out] Указатель на структуру MAPIUID , содержащую уникальный идентификатор, представляющий добавляемый поставщик.

Возвращаемое значение

S_OK

Поставщик успешно добавлен в службу сообщений.

MAPI_E_USER_CANCEL

Пользователь отменил операцию, обычно нажав кнопку Отмена в диалоговом окне.

Замечания

Метод IProviderAdmin::CreateProvider добавляет поставщика услуг в службу сообщений. Параметр lpszProvider должен указывать на имя поставщика, который принадлежит службе сообщений. CreateProvider не проверяет, соответствует ли имя имени поставщика в службе; Если переданное имя не соответствует имени службы, вызов будет выполнен успешно, но результаты непредсказуемы. Большинство служб сообщений не позволяют добавлять или удалять поставщиков во время использования профиля.

После того как все доступные сведения о поставщике услуг будут добавлены в профиль из файла Mapisvc.inf, CreateProvider вызывает функцию точки входа службы сообщений с параметром ulContext , для которого задано значение MSG_SERVICE_PROVIDER_CREATE. Если MAPI_DIALOG задано в параметре ulFlags метода CreateProvider, значения в параметрах ulUIParam и ulFlags также передаются в функцию точки входа. Эти дополнительные параметры позволяют поставщику услуг отображать свой лист свойств, чтобы пользователь смог ввести параметры конфигурации.

См. также