IProfAdmin::CreateProfile

Статья
04/04/2023

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

Создает новый профиль.

HRESULT CreateProfile(
  LPSTR lpszProfileName,
  LPSTR lpszPassword,
  ULONG_PTR ulUIParam,
  ULONG ulFlags
);

Параметры

lpszProfileName

[в] Указатель на имя нового профиля.

lpszPassword

[в] Указатель на пароль нового профиля.

ulUIParam

[в] Дескриптор родительского окна всех диалоговых окон или окон, отображаемых этим методом.

ulFlags

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

MAPI_APP_PROFILE

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

Этот флаг не распознается или поддерживается во всех реализациях MAPI.

MAPI_DEFAULT_SERVICES

MAPI должен заполнить новый профиль службами сообщений, включенными в раздел [Службы по умолчанию] файла Mapisvc.inf.

MAPI_DIALOG

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

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

S_OK

Создан новый профиль.

MAPI_E_NO_ACCESS

Указанный новый профиль уже существует.

Замечания

Метод IProfAdmin::CreateProfile создает новый профиль.

Примечания для вызывающих методов

Вы можете вызвать CreateProfile во время установки приложения или в любое время во время сеанса. При вызове этого метода во время установки многие параметры конфигурации поступают из файла конфигурации Mapisvc.inf. При вызове этого метода во время активного сеанса параметры поступают от пользователя, которому будет предложено использовать ряд листов свойств.

Если флаг MAPI_DEFAULT_SERVICES задан в параметре ulFlags , CreateProfile вызывает функцию точки входа службы сообщений для каждой службы сообщений в разделе [Службы по умолчанию] в файле Mapisvc.inf. Каждая функция точки входа службы сообщений вызывается с параметром ulContext , равным MSG_SERVICE_CREATE.

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

Имя нового профиля и его пароль могут содержать до 64 символов и могут содержать следующие символы: