Partager via


IProfAdmin::CreateProfile

S’applique à : Outlook 2013 | Outlook 2016

Crée un profil.

HRESULT CreateProfile(
  LPSTR lpszProfileName,
  LPSTR lpszPassword,
  ULONG_PTR ulUIParam,
  ULONG ulFlags
);

Paramètres

lpszProfileName

[in] Pointeur vers le nom du nouveau profil.

lpszPassword

[in] Pointeur vers le mot de passe du nouveau profil.

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 créé. Les indicateurs suivants peuvent être définis :

MAPI_APP_PROFILE

MAPI doit créer ce profil en tant que profil « application », ce qui limite la détectabilité et les interactions.

Cet indicateur peut ne pas être reconnu ou pris en charge dans toutes les implémentations MAPI.

MAPI_DEFAULT_SERVICES

MAPI doit remplir le nouveau profil avec les services de message inclus dans la section [Services par défaut] du fichier Mapisvc.inf.

MAPI_DIALOG

Les feuilles de propriétés de configuration de chacun des fournisseurs dans les services de message à ajouter peuvent être affichées.

Valeur renvoyée

S_OK

Le nouveau profil a été créé.

MAPI_E_NO_ACCESS

Le nouveau profil spécifié existe déjà.

Remarques

La méthode IProfAdmin ::CreateProfile crée un profil.

Remarques pour les appelants

Vous pouvez appeler CreateProfile au moment de l’installation de l’application ou à tout moment pendant une session. Lorsque cette méthode est appelée au moment de l’installation, la plupart des paramètres de configuration proviennent du fichier de configuration Mapisvc.inf. Lorsque cette méthode est appelée au cours d’une session active, les paramètres proviennent de l’utilisateur qui est invité par le biais d’une série de feuilles de propriétés.

Si l’indicateur MAPI_DEFAULT_SERVICES est défini dans le paramètre ulFlags , CreateProfile appelle la fonction de point d’entrée du service de message pour chaque service de message dans la section [Services par défaut] du fichier Mapisvc.inf. Chaque fonction de point d’entrée de service de message est appelée avec le paramètre ulContext défini sur MSG_SERVICE_CREATE.

Si les indicateurs MAPI_DIALOG et MAPI_DEFAULT_SERVICES sont définis, les valeurs des paramètres ulUIParam et ulFlags sont également passées à la fonction de point d’entrée du service de message. Les fonctions de point d’entrée du service de message sont appelées uniquement une fois que toutes les informations disponibles à partir du fichier Mapisvc.inf ont été ajoutées au profil.

Le nom du nouveau profil et son mot de passe 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.

Le paramètre lpszPassword doit être NULL ou un pointeur vers une chaîne de longueur nulle.

Voir aussi

IMsgServiceAdmin::ConfigureMsgService

IMsgServiceAdmin::CreateMsgService

MSGSERVICEENTRY

IProfAdmin : IUnknown