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