IXPLogon::FlushQueues
S’applique à : Outlook 2013 | Outlook 2016
Demande au fournisseur de transport de remettre immédiatement tous les messages entrants ou sortants en attente.
HRESULT FlushQueues(
ULONG_PTR ulUIParam,
ULONG cbTargetTransport,
LPENTRYID lpTargetTransport,
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.
cbTargetTransport
[in] R�serv� ; doit �tre �gal � z�ro.
lpTargetTransport
[in] Réservés au; doit avoir la valeur NULL.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont le vidage de la file d’attente des messages est effectué. Les indicateurs suivants peuvent être définis :
FLUSH_DOWNLOAD
La ou les files d’attente de messages entrants doivent être vidées.
FLUSH_FORCE
Le fournisseur de transport doit traiter cette demande, si possible, même si cela prend beaucoup de temps.
FLUSH_NO_UI
Le fournisseur de transport ne doit pas afficher d’interface utilisateur.
FLUSH_UPLOAD
La ou les files d’attente de messages sortants doivent être vidées.
Valeur renvoyée
S_OK
L’appel a réussi et a retourné la ou les valeurs attendues.
Remarques
Le spouleur MAPI appelle la méthode IXPLogon ::FlushQueues pour informer le fournisseur de transport que le spouleur MAPI est sur le point de commencer le traitement des messages. Le fournisseur de transport doit appeler la méthode IMAPISupport ::ModifyStatusRow pour définir un bit approprié pour son état dans la propriété PR_STATUS_CODE (PidTagStatusCode) de sa ligne status. Après avoir mis à jour sa ligne status, le fournisseur de transport doit retourner S_OK pour l’appel FlushQueues. Le spouleur MAPI commence ensuite à envoyer des messages, l’opération étant synchrone avec le spouleur MAPI.
Pour prendre en charge son implémentation de la méthode IMAPIStatus ::FlushQueues , le spouleur MAPI appelle IXPLogon ::FlushQueues pour tous les objets d’ouverture de session pour les fournisseurs de transport actifs qui s’exécutent dans une session de profil. Quand la méthode FlushQueues d’un fournisseur de transport est appelée à la suite d’un appel d’application cliente à IMAPIStatus ::FlushQueues, le traitement des messages se produit de façon asynchrone pour le client.