IProfAdmin::SetDefaultProfile
Область применения: Outlook 2013 | Outlook 2016
Задает или очищает профиль клиента по умолчанию.
HRESULT SetDefaultProfile(
LPSTR lpszProfileName,
ULONG ulFlags
);
Параметры
lpszProfileName
[в] Указатель на имя профиля, который станет значением по умолчанию или NULL. Если для параметра lpszProfileName задано значение NULL, setDefaultProfile должен удалить существующий профиль по умолчанию, оставив клиент без значения по умолчанию.
ulFlags
[в] Битовая маска флагов, управляющая типом строки, на которую указывает lpszProfileName. Можно задать следующий флаг:
MAPI_UNICODE
Имя профиля в формате Юникода. Если флаг MAPI_UNICODE не задан, имя профиля имеет формат ANSI.
Возвращаемое значение
S_OK
Профиль по умолчанию успешно установлен или удален.
E_FAIL
Указанный профиль нельзя задать в качестве профиля по умолчанию.
MAPI_E_NOT_FOUND
Указанный профиль не существует.
Замечания
Метод IProfAdmin::SetDefaultProfile устанавливает определенный профиль в качестве профиля клиента по умолчанию или очищает текущий профиль по умолчанию. Профиль "приложение" нельзя задать в качестве профиля по умолчанию. Профиль по умолчанию — это профиль, который автоматически используется каждый раз, когда клиент начинает сеанс MAPI. SetDefaultProfile также задает для свойства PR_DEFAULT_PROFILE (PidTagDefaultProfile) нового профиля по умолчанию значение TRUE.
Примечания для вызывающих методов
Чтобы начать сеанс с профилем по умолчанию, передайте флаг MAPI_USE_DEFAULT функции MAPILogonEx .