IProfAdmin::AdminServices
S’applique à : Outlook 2013 | Outlook 2016
Fournit l’accès à un objet d’administration de service de message pour apporter des modifications aux services de message dans un profil.
HRESULT AdminServices(
LPSTR lpszProfileName,
LPSTR lpszPassword,
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPSERVICEADMIN FAR * lppServiceAdmin
);
Paramètres
lpszProfileName
[in] Pointeur vers le nom du profil à modifier. Le paramètre lpszProfileName ne doit pas être NULL.
lpszPassword
[in] Toujours NULL.
ulUIParam
[in] Handle de la fenêtre parente pour 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 récupération de l’objet d’administration du service de messages. Les indicateurs suivants peuvent être définis :
MAPI_DIALOG
Active l’affichage d’une interface utilisateur.
MAPI_UNICODE
Le nom du profil est au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, le nom est au format ANSI.
lppServiceAdmin
[out] Pointeur vers un pointeur vers un objet d’administration de service de message.
Valeur renvoyée
S_OK
L’objet d’administration du service de message a été retourné avec succès.
MAPI_E_LOGON_FAILED
Le profil spécifié n’existe pas, ou le mot de passe était 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 ulFlags.
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 ::AdminServices permet d’accéder à un objet d’administration de service de message pour apporter des modifications à la configuration des services de message dans un profil.
Le paramètre lpszPassword doit être NULL ou un pointeur vers une chaîne de longueur nulle.
Remarques pour les appelants
Bien que vous puissiez récupérer un pointeur IMsgServiceAdmin en appelant cette méthode ou IMAPISession ::AdminServices, appelez IProfAdmin ::AdminServices si vous avez strictement un client de configuration et que vous n’offre aucune fonctionnalité de messagerie. IProfAdmin ::AdminServices ne crée pas d’objet de session et ne charge aucun fournisseur de services, ce qui améliore les performances.
Vous ne pouvez pas utiliser IProfAdmin ::AdminServices pour créer un profil. Par conséquent, vous devez spécifier un profil valide existant dans lpszProfileName. Si le profil spécifié n’existe pas, IProfAdmin ::AdminServices retourne MAPI_E_LOGON_FAILED.
Le nom du profil peut comporter jusqu’à 64 caractères et peut 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.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| MAPIProfileFunctions.cpp |
HrAddServiceToProfile |
MFCMAPI utilise la méthode IProfAdmin ::AdminServices pour ouvrir un objet d’administration de service de message pour le profil sélectionné afin d’ajouter des services. |