Partager via


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.

Voir aussi

IProfAdmin : IUnknown