IXPLogon::ValidateState
S’applique à : Outlook 2013 | Outlook 2016
Vérifie les status externes du fournisseur de transport.
HRESULT ValidateState(
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Paramètres
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 la status case activée est effectuée et les résultats de l’status case activée. Les indicateurs suivants peuvent être définis :
ABORT_XP_HEADER_OPERATION
L’utilisateur a annulé l’opération, généralement en cliquant sur le bouton Annuler dans une boîte de dialogue. Le fournisseur de transport a la possibilité de continuer à travailler sur l’opération, ou il peut abandonner l’opération et retourner MAPI_E_USER_CANCELED.
CONFIG_CHANGED
Valide l’état des fournisseurs de transport actuellement chargés en obligeant le spouleur MAPI à appeler leur méthode IXPLogon ::AddressTypes . Cet indicateur permet également au spouleur MAPI de corriger les défaillances critiques du fournisseur de transport sans forcer les applications clientes à se déconnecter, puis à se reconnecter.
FORCE_XP_CONNECT
L’utilisateur a sélectionné une opération de connexion. Lorsque cet indicateur est utilisé avec l’indicateur REFRESH_XP_HEADER_CACHE ou PROCESS_XP_HEADER_CACHE, l’action de connexion se produit sans mise en cache.
FORCE_XP_DISCONNECT
L’utilisateur a sélectionné une opération de déconnexion. Lorsque cet indicateur est utilisé avec REFRESH_XP_HEADER_CACHE ou PROCESS_XP_HEADER_CACHE, l’action de déconnexion se produit sans mise en cache.
PROCESS_XP_HEADER_CACHE
Les entrées de la table de cache d’en-tête doivent être traitées, tous les messages marqués avec l’indicateur MSGSTATUS_REMOTE_DOWNLOAD doivent être téléchargés et tous les messages marqués avec l’indicateur MSGSTATUS_REMOTE_DELETE doivent être supprimés. Les messages qui ont à la fois MSGSTATUS_REMOTE_DOWNLOAD et MSGSTATUS_REMOTE_DELETE définis doivent être déplacés.
REFRESH_XP_HEADER_CACHE
Une nouvelle liste d’en-têtes de message doit être téléchargée et tous les indicateurs de marquage status message doivent être effacés.
SUPPRESS_UI
Empêche le fournisseur de transport d’afficher une interface utilisateur.
Valeur renvoyée
S_OK
L’appel a réussi et a retourné la ou les valeurs attendues.
MAPI_E_BUSY
Une autre opération est en cours ; elle doit être autorisée à se terminer, ou elle doit être arrêtée avant la tentative de cette opération.
MAPI_E_NO_SUPPORT
Le fournisseur de transport distant impliqué ne prend pas en charge une interface utilisateur, et l’application cliente elle-même doit afficher la boîte de dialogue.
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
Le spouleur MAPI appelle la méthode IXPLogon ::ValidateState pour prendre en charge les appels à la méthode IMAPIStatus ::ValidateState pour l’objet status. Le fournisseur de transport doit répondre à l’appel IXPLogon ::ValidateState exactement comme si le spouleur MAPI avait ouvert un objet status pour la session d’ouverture de session active, puis appelé IMAPIStatus ::ValidateState sur cet objet.
Pour prendre en charge son implémentation de IMAPIStatus ::ValidateState, le spouleur MAPI appelle IXPLogon ::ValidateState sur tous les objets d’ouverture de session pour tous les fournisseurs de transport actifs qui s’exécutent dans une session de profil.