IMsgStore::StoreLogoff
S’applique à : Outlook 2013 | Outlook 2016
Active la déconnexion ordonnée de la banque de messages.
HRESULT StoreLogoff(
ULONG FAR * lpulFlags
);
Paramètres
lpulFlags
[in, out] Masque de bits d’indicateurs qui contrôle la déconnexion à partir de la banque de messages. En entrée, tous les indicateurs définis pour ce paramètre s’excluent mutuellement ; un appelant doit spécifier un seul indicateur par appel. Les indicateurs suivants sont valides en entrée :
LOGOFF_ABORT
Toute activité de fournisseur de transport pour cette banque de messages doit être arrêtée avant la fermeture de session. Le contrôle est retourné à l’appelant après l’arrêt de l’activité. Si une activité de fournisseur de transport a lieu, la déconnexion ne se produit pas et aucun changement dans le comportement du spouleur MAPI ou des fournisseurs de transport ne se produit. Si l’activité du fournisseur de transport est inactive, le spouleur MAPI libère le magasin.
LOGOFF_NO_WAIT
La banque de messages ne doit pas attendre les messages des fournisseurs de transport avant de se fermer. Les messages sortants prêts à être envoyés sont envoyés. Si ce magasin contient la boîte de réception par défaut, tous les messages in-process sont reçus, puis la réception supplémentaire est désactivée. Une fois toute l’activité terminée, le spouleur MAPI libère le magasin et le contrôle est immédiatement retourné à l’appelant.
LOGOFF_ORDERLY
La banque de messages ne doit pas attendre les informations des fournisseurs de transport avant de se fermer. Les messages en cours de traitement sont terminés, mais aucun nouveau message n’est traité. Une fois toute l’activité terminée, le spouleur MAPI libère le magasin et le contrôle est immédiatement retourné au fournisseur du magasin.
LOGOFF_PURGE
La fermeture de session doit fonctionner de la même façon que si l’indicateur LOGOFF_NO_WAIT est défini, mais la méthode IXPLogon ::FlushQueues ou IMAPIStatus ::FlushQueues pour les fournisseurs de transport appropriés doit être appelée. L’indicateur LOGOFF_PURGE retourne le contrôle à l’appelant une fois l’opération terminée.
LOGOFF_QUIET
Si une activité de fournisseur de transport a lieu, la déconnexion ne doit pas se produire.
Les indicateurs suivants sont valides sur la sortie
LOGOFF_INBOUND
Les messages entrants arrivent actuellement.
LOGOFF_OUTBOUND
Les messages sortants sont en cours d’envoi.
LOGOFF_OUTBOUND_QUEUE
Les messages sortants sont en attente (autrement dit, ils sont dans la boîte d’envoi).
Valeur renvoyée
S_OK
La fermeture de session s’est terminée avec succès.
Remarques
La méthode IMsgStore ::StoreLogoff exerce un contrôle sur l’interaction des fournisseurs de magasin de messages et de transport pendant le processus de déconnexion. L’appel de StoreLogoff est valide uniquement pour les magasins de messages utilisés uniquement par l’appelant. Par exemple, lorsque deux clients utilisent la même banque de messages et que l’un d’eux appelle StoreLogoff, la banque de messages est immédiatement libérée et le contrôle est retourné au client appelant.
Remarques pour les responsables de l’implémentation
Enregistrez les indicateurs passés à StoreLogoff et passez-les lorsque vous appelez la méthode IMAPISupport ::StoreLogoffTransports . N’appelez pas StoreLogoffTransports tant que le nombre de références de la banque de messages n’est pas inférieur à zéro. Plusieurs appels à StoreLogoffTransports remplacent simplement les indicateurs enregistrés.
Si aucun appel n’a été effectué à StoreLogoff avant que le nombre de références de la banque de messages n’atteigne zéro, définissez l’indicateur LOGOFF_ABORT dans le paramètre ulFlags que vous transmettez à StoreLogoffTransports.