Vérification de la configuration du fournisseur de services
S’applique à : Outlook 2013 | Outlook 2016
Votre méthode d’ouverture de session (IABProvider ::Logon, IMSProvider ::Logon ou IXPProvider ::TransportLogon) doit vérifier la configuration de votre fournisseur. Cela implique de vérifier que toutes les propriétés nécessaires au fonctionnement complet sont correctement définies. Chaque fournisseur a besoin d’un nombre différent de propriétés ; la configuration dépend de votre fournisseur et du degré d’interaction utilisateur que vous autorisez. Certains fournisseurs de services conservent toutes les propriétés nécessaires dans le profil.
D’autres fournisseurs de services conservent un ensemble partiel de propriétés dans le profil et invitent l’utilisateur à indiquer les valeurs manquantes. D’autres fournisseurs ne stockent pas du tout les propriétés dans le profil, en s’appuyant sur l’utilisateur pour fournir toutes les informations nécessaires à la configuration.
Pour récupérer les propriétés stockées dans le profil
Appelez IMAPISupport ::OpenProfileSection en passant le MAPIUID de votre fournisseur en tant que paramètre d’entrée.
Appelez les méthodes IMAPIProp ::GetProps ou IMAPIProp ::GetPropList de la section de profil pour récupérer des propriétés individuelles ou une liste de propriétés.
Pour définir les propriétés des informations utilisateur
Afficher une feuille de propriétés si MAPI n’a pas défini d’indicateur interdisant l’affichage. Les indicateurs suivants indiquent qu’une interface utilisateur ne peut pas être présentée.
Indicateur | Fournisseur |
---|---|
AB_NO_DIALOG |
Fournisseur de carnet d’adresses |
LOGON_NO_DIALOG |
Fournisseur de transport |
MDB_NO_DIALOG |
Fournisseur de magasin de messages |
Si votre fournisseur ne stocke pas toutes ses propriétés de configuration dans le profil, ce qui nécessite une interaction utilisateur et que MAPI transmet l’un des indicateurs de suppression de boîte de dialogue à votre méthode d’ouverture de session, retournez MAPI_E_UNCONFIGURED. Retourne également cette erreur lorsque l’indicateur de suppression de boîte de dialogue n’est pas défini, mais que l’utilisateur ne fournit pas toutes les informations requises.
Lorsque votre fournisseur de services échoue à sa méthode d’ouverture de session avec MAPI_E_UNCONFIGURED, MAPI appelle à nouveau votre fonction de point d’entrée. Si les informations ne peuvent pas être localisées avec le deuxième appel, la session peut se terminer, en fonction de l’importance de votre fournisseur de services.
L’illustration suivante montre la logique requise pour la configuration dans votre méthode d’ouverture de session de fournisseur de services.
Diagramme de flux de vérification de la configuration