IProfAdmin::RenameProfile
S’applique à : Outlook 2013 | Outlook 2016
Attribue un nouveau nom à un profil.
HRESULT RenameProfile(
LPSTR lpszOldProfileName,
LPSTR lpszOldPassword,
LPSTR lpszNewProfileName,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Paramètres
lpszOldProfileName
[in] Pointeur vers le nom actuel du profil à renommer.
lpszOldPassword
[in] Toujours NULL.
lpszNewProfileName
[in] Pointeur vers le nouveau nom du profil à renommer.
ulUIParam
[in] Handle vers la fenêtre parente de toutes les boîtes de dialogue ou fenêtres affichées par cette méthode.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont le profil est renommé. L’indicateur suivant peut être défini :
MAPI_APP_PROFILE
Permet de renommer un profil « application ». Cet indicateur doit être défini si le profil est un profil « application ».
Cet indicateur peut ne pas être reconnu ou pris en charge dans toutes les implémentations MAPI.
Valeur renvoyée
S_OK
Le profil a été renommé avec succès.
MAPI_E_LOGON_FAILED
Le mot de passe du profil est incorrect.
MAPI_E_NO_ACCESS
Le profil est un profil « application » et l’indicateur MAPI_APP_PROFILE n’a pas été défini.
MAPI_E_USER_CANCEL
L’utilisateur a annulé l’opération, généralement en cliquant sur le bouton Annuler dans une boîte de dialogue.
Remarques
La méthode IProfAdmin ::RenameProfile attribue un nouveau nom à un profil, le cas échéant. Si le profil à renommer est en cours d’utilisation par un client lorsque RenameProfile est appelé, RenameProfile marque le profil et retourne S_OK au lieu de tenter l’opération de renommage pendant l’utilisation du profil. Lorsque le profil n’est plus utilisé, RenameProfile lui attribue le nouveau nom.
Les anciens et nouveaux noms du profil peuvent comporter jusqu’à 64 caractères et peuvent inclure les caractères suivants :
Tous les caractères alphanumériques, y compris les caractères d’accentuation et le caractère de soulignement.
Espaces incorporés, mais pas espaces de début ou de fin.
LpszPassword doit toujours avoir la valeur NULL ou un pointeur vers une chaîne de longueur nulle.