IProfAdmin::AdminServices
Область применения: Outlook 2013 | Outlook 2016
Предоставляет доступ к объекту администрирования службы сообщений для внесения изменений в службы сообщений в профиле.
HRESULT AdminServices(
LPSTR lpszProfileName,
LPSTR lpszPassword,
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPSERVICEADMIN FAR * lppServiceAdmin
);
Параметры
lpszProfileName
[в] Указатель на имя изменяемого профиля. Параметр lpszProfileName не должен иметь значение NULL.
lpszPassword
[в] Всегда значение NULL.
ulUIParam
[в] Дескриптор родительского окна для любых диалоговых окон или окон, отображаемых этим методом.
ulFlags
[в] Битовая маска флагов, управляющая получением объекта администрирования службы сообщений. Можно задать следующие флаги:
MAPI_DIALOG
Включает отображение пользовательского интерфейса.
MAPI_UNICODE
Имя профиля в формате Юникода. Если флаг MAPI_UNICODE не задан, имя имеет формат ANSI.
lppServiceAdmin
[out] Указатель на указатель на объект администрирования службы сообщений.
Возвращаемое значение
S_OK
Объект администрирования службы сообщений был успешно возвращен.
MAPI_E_LOGON_FAILED
Указанный профиль не существует, или пароль был неправильным, и пользователю не удалось отобразить диалоговое окно для запроса правильного пароля, так как MAPI_DIALOG не был задан в ulFlags.
MAPI_E_USER_CANCEL
Пользователь отменил операцию, обычно нажав кнопку Отмена в диалоговом окне.
Замечания
Метод IProfAdmin::AdminServices предоставляет доступ к объекту администрирования службы сообщений для внесения изменений в конфигурацию служб сообщений в профиле.
Параметр lpszPassword должен иметь значение NULL или указатель на строку нулевой длины.
Примечания для вызывающих методов
Хотя вы можете получить указатель IMsgServiceAdmin , вызвав либо этот метод, либо IMAPISession::AdminServices, вызовите IProfAdmin::AdminServices, если у вас есть строго клиент конфигурации и нет функций обмена сообщениями. IProfAdmin::AdminServices не создает объект сеанса и не загружает поставщиков служб, что повышает производительность.
Для создания профиля нельзя использовать IProfAdmin::AdminServices . Поэтому необходимо указать существующий допустимый профиль в lpszProfileName. Если указанный профиль не существует, функция IProfAdmin::AdminServices возвращает MAPI_E_LOGON_FAILED.
Имя профиля может содержать до 64 символов в длину и может содержать следующие символы:
Все буквенно-цифровые символы, включая знаки акцента и символ подчеркивания.
Внедренные пространства, но не начальные или конечные пробелы.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| MAPIProfileFunctions.cpp |
HrAddServiceToProfile |
MFCMAPI использует метод IProfAdmin::AdminServices , чтобы открыть объект администрирования службы сообщений для выбранного профиля для добавления служб. |