IProfAdmin::CopyProfile
S’applique à : Outlook 2013 | Outlook 2016
Copie un profil.
HRESULTCopyProfile(
LPSTR lpszOldProfileName,
LPSTR lpszOldPassword,
LPSTR lpszNewProfileName,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Paramètres
lpszOldProfileName
[in] Pointeur vers le nom du profil à copier.
lpszOldPassword
[in] Pointeur vers le mot de passe du profil à copier.
lpszNewProfileName
[in] Pointeur vers le nouveau nom du profil copié.
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 copié. Les indicateurs suivants peuvent être définis :
MAPI_APP_PROFILE
Autorise la copie d’un profil « application ». Cet indicateur doit être défini si le profil existant est un profil « application ».
Cet indicateur peut ne pas être reconnu ou pris en charge dans toutes les implémentations MAPI.
MAPI_DIALOG
Affiche une boîte de dialogue qui invite l’utilisateur à entrer le mot de passe correct du profil à copier. Si cet indicateur n’est pas défini, aucune boîte de dialogue n’est affichée.
Valeur renvoyée
S_OK
Le profil a été copié avec succès.
MAPI_E_ACCESS_DENIED
Le nouveau nom de profil est identique à celui d’un profil existant.
MAPI_E_LOGON_FAILED
Le mot de passe du profil à copier est incorrect et une boîte de dialogue n’a pas pu être affichée à l’utilisateur pour demander le mot de passe correct, car MAPI_DIALOG n’a pas été défini dans le paramètre ulFlags .
MAPI_E_NO_ACCESS
Le profil existant est un profil « application » et l’indicateur MAPI_APP_PROFILE n’a pas été défini.
MAPI_E_NOT_FOUND
Le profil spécifié n’existe pas.
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 ::CopyProfile effectue une copie du profil vers lequel pointe lpszOldProfileName, en lui attribuant le nom pointé par lpszNewProfileName. La copie d’un profil laisse la copie avec le même mot de passe que l’original.
Le nom du profil d’origine, son mot de passe et la copie peuvent contenir 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.
Les mots de passe de profil ne sont pas pris en charge sur tous les systèmes d’exploitation. Sur les systèmes d’exploitation qui ne prennent pas en charge les mots de passe de profil, lpszOldPassword peut être NULL ou un pointeur vers une chaîne de longueur nulle.
Si lpszOldPassword est défini sur NULL, le profil à copier nécessite un mot de passe et l’indicateur MAPI_DIALOG est défini . une boîte de dialogue qui invite l’utilisateur à fournir le mot de passe s’affiche. Si un mot de passe est requis, mais que lpszOldPassword a la valeur NULL et que l’indicateur MAPI_DIALOG n’est pas défini, CopyProfile renvoie MAPI_E_LOGON_FAILED.
Si le profil existant est un profil « application » et que l’indicateur MAPI_APP_PROFILE n’est pas défini, CopyProfile renvoie MAPI_E_NO_ACCESS. Si le profil existant est un profil « application » et que le MAPI_APP_PROFILE est défini, le nouveau profil est également un profil « application ». Si le profil existant n’est pas un profil « application », le nouveau profil n’est pas un profil « application », quel que soit l’indicateur de MAPI_APP_PROFILE.