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_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_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.