LAUNCHWIZARDENTRY

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

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

Свойство	Значение
Файл заголовка:	Mapiwz.h
Определена функция, реализованная:	MAPI
Определенная функция, вызываемая:	Клиентские приложения

HRESULT LAUNCHWIZARDENTRY(
  HWND hParentWnd,
  ULONG ulFlags,
  LPCSTR FAR * lppszServiceNameToAdd,
  ULONG cbBufferMax,
  LPSTR lpszNewProfileName
);

Параметры

hParentWnd

[в] Дескриптор родительского окна вызывающего объекта. Если у вызывающего объекта нет родительского окна, параметр hParentWnd должен иметь значение NULL.

ulFlags

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

MAPI_PW_ADD_SERVICE_ONLY

Мастер профилей добавляет только службы сообщений, перечисленные в параметре lppszServiceNameToAdd , и не отображает страницу для выбора служб сообщений.

MAPI_PW_FIRST_PROFILE

Созданный профиль является первым для этой рабочей станции.

MAPI_PW_HIDE_SERVICES_LIST

Страница мастера профилей для выбора служб сообщений не должна отображаться.

MAPI_PW_LAUNCHED_BY_CONFIG

Мастер профилей был запущен приложением конфигурации панель управления.

MAPI_PW_PROVIDER_UI_ONLY

Должны отображаться только диалоговые окна конфигурации поставщиков услуг, а страницы мастера профилей не должны отображаться. Этот флаг можно задать только в том случае, если установлен флаг MAPI_PW_ADD_SERVICE_ONLY.

lppszServiceNameToAdd

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

cbBufferMax

[в] Размер буфера, на который указывает параметр lpszNewProfileName .

lpszNewProfileName

[out] Указатель на буфер строк, где функция, основанная на LAUNCHWIZARDENTRY , возвращает имя созданного профиля.

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

S_OK

����� ������� � ������ ��������� ��������� ��� ��������.

MAPI_E_CALL_FAILED

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

Замечания

Реализация MAPI прототипа функции LAUNCHWIZARDENTRY является точкой входа в приложение мастера профилей MAPI. MAPI называет эту точку входа LaunchWizard.

Если флаг MAPI_PW_ADD_SERVICE_ONLY задан в параметре ulFlags , применяются следующие правила:

• Флаг MAPI_PW_LAUNCHED_BY_CONFIG запрещает отображение страницы приветствия.

• Флаги MAPI_PW_HIDE_SERVICES_LIST и MAPI_PW_PROVIDER_UI_ONLY полезны, только если нет профиля по умолчанию. В этом случае эти флаги определяют, какая страница мастера профилей должна отображаться.

• Если профиль по умолчанию существует, ни одна из страниц мастера профилей не должна отображаться.

• Если профиль по умолчанию существует, с помощью параметра lppszServiceNameToAdd отображается только одна служба сообщений, и эта служба сообщений уже находится в профиле по умолчанию, мастер профилей возвращает S_OK, ничего не добавляя в профиль.

Для добавления каждой службы сообщений в профиль мастер профилей вызывает функцию точки входа службы на основе прототипа MSGSERVICEENTRY . Для каждого поставщика услуг, выбранного из службы сообщений для добавления в профиль, мастер профилей вызывает функцию точки входа поставщика на основе прототипа WIZARDENTRY . Во время интерактивной настройки каждое событие пользователя на страницах свойств приводит к тому, что мастер профилей вызывает функцию обратного вызова поставщика на основе прототипа SERVICEWIZARDDLGPROC .

Если поставщик услуг, добавляемый в профиль, поддерживает страницы мастера профилей, он должен разрешить программную настройку профиля.