IProfAdmin::RenameProfile
Область применения: Outlook 2013 | Outlook 2016
Назначает новое имя профилю.
HRESULT RenameProfile(
LPSTR lpszOldProfileName,
LPSTR lpszOldPassword,
LPSTR lpszNewProfileName,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Параметры
lpszOldProfileName
[в] Указатель на текущее имя профиля для переименования.
lpszOldPassword
[в] Всегда значение NULL.
lpszNewProfileName
[в] Указатель на новое имя профиля для переименования.
ulUIParam
[в] Дескриптор родительского окна всех диалоговых окон или окон, отображаемых этим методом.
ulFlags
[в] Битовая маска флагов, управляющая переименованием профиля. Можно задать следующий флаг:
MAPI_APP_PROFILE
Позволяет переименовать профиль приложения. Этот флаг необходимо задать, если профиль является профилем приложения.
Этот флаг не распознается или поддерживается во всех реализациях MAPI.
Возвращаемое значение
S_OK
Профиль был успешно переименован.
MAPI_E_LOGON_FAILED
Неправильный пароль профиля.
MAPI_E_NO_ACCESS
Профиль является профилем приложения, и флаг MAPI_APP_PROFILE не задан.
MAPI_E_USER_CANCEL
Пользователь отменил операцию, обычно нажав кнопку Отмена в диалоговом окне.
Замечания
Метод IProfAdmin::RenameProfile присваивает новое имя профилю, если оно имеется. Если профиль для переименования используется клиентом при вызове RenameProfile , функция RenameProfile помечает профиль и возвращает S_OK вместо попытки переименования во время использования профиля. Если профиль больше не используется, RenameProfile присваивает ему новое имя.
Старые и новые имена профиля могут содержать до 64 символов и могут содержать следующие символы:
Все буквенно-цифровые символы, включая знаки акцента и символ подчеркивания.
Внедренные пространства, но не начальные или конечные пробелы.
LpszPassword всегда должен иметь значение NULL или указатель на строку нулевой длины.