IMAPISession::Logoff
S’applique à : Outlook 2013 | Outlook 2016
Met fin à une session MAPI.
HRESULT Logoff(
ULONG_PTR ulUIParam,
ULONG ulFlags,
ULONG ulReserved
);
Paramètres
ulUIParam
[in] Handle vers la fenêtre parente de toutes les boîtes de dialogue ou fenêtres à afficher. Ce paramètre est ignoré si l’indicateur MAPI_LOGOFF_UI n’est pas défini.
ulFlags
[in] Masque de bits d’indicateurs qui contrôlent l’opération de déconnexion. Les indicateurs suivants peuvent être définis :
MAPI_LOGOFF_SHARED
Si cette session est partagée, tous les clients qui se sont connectés à l’aide de la session partagée doivent être avertis de la fermeture de session en cours. Les clients doivent se déconnecter. Tout client qui utilise la session partagée peut définir cet indicateur. MAPI_LOGOFF_SHARED est ignoré si la session active n’est pas partagée.
MAPI_LOGOFF_UI
La déconnexion peut afficher une boîte de dialogue pendant l’opération, invitant éventuellement l’utilisateur à confirmer.
ulReserved
[in] R�serv� ; doit �tre �gal � z�ro.
Valeur renvoyée
S_OK
L’opération de déconnexion a réussi.
Remarques
La méthode IMAPISession ::Logoff met fin à une session MAPI. Lorsque logoff est retourné, aucune des méthodes à l’exception de IUnknown ::Release ne peut être appelée.
Remarques pour les appelants
Lorsque logoff est retourné, libérez l’objet session en appelant sa méthode IUnknown ::Release .
Pour plus d’informations sur la fin d’une session, consultez Fin d’une session MAPI.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| MAPIObjects.cpp |
CMapiObjects ::Logoff |
MFCMAPI utilise la méthode IMAPISession ::Logoff pour se déconnecter de la session avant de la libérer. |
Remarque
En raison du comportement d’arrêt rapide introduit dans Microsoft Office Outlook 2007 Service Pack 2, Microsoft Outlook 2010 et Microsoft Outlook 2013, les clients ne doivent jamais passer le paramètre MAPI_LOGOFF_SHARED à IMAPISession ::Logoff. Le passage de MAPI_LOGOFF_SHARED entraîne l’arrêt de tous les clients MAPI et un comportement inattendu se produit.