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] Toujours NULL.
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_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.