IMAPISession::Logoff
Gilt für: Outlook 2013 | Outlook 2016
Beendet eine MAPI-Sitzung.
HRESULT Logoff(
ULONG_PTR ulUIParam,
ULONG ulFlags,
ULONG ulReserved
);
Parameter
ulUIParam
[in] Ein Handle für das übergeordnete Fenster aller anzuzeigenden Dialogfelder oder Fenster. Dieser Parameter wird ignoriert, wenn das MAPI_LOGOFF_UI-Flag nicht festgelegt ist.
ulFlags
[in] Eine Bitmaske von Flags, die den Abmeldungsvorgang steuern. Die folgenden Flags können festgelegt werden:
MAPI_LOGOFF_SHARED
Wenn diese Sitzung freigegeben ist, sollten alle Clients, die sich mit der freigegebenen Sitzung angemeldet haben, über die derzeit durchgeführte Abmeldung benachrichtigt werden. Die Clients sollten sich abmelden. Jeder Client, der die freigegebene Sitzung verwendet, kann dieses Flag festlegen. MAPI_LOGOFF_SHARED wird ignoriert, wenn die aktuelle Sitzung nicht freigegeben ist.
MAPI_LOGOFF_UI
Abmeldung kann während des Vorgangs ein Dialogfeld anzeigen, das den Benutzer möglicherweise zur Bestätigung auffordert.
ulReserved
[in] Reserviert. NULL muss sein.
Rückgabewert
S_OK
Der Abmeldevorgang war erfolgreich.
Hinweise
Die IMAPISession::Logoff-Methode beendet eine MAPI-Sitzung. Wenn Logoff zurückgibt, kann keine der Methoden außer IUnknown::Release aufgerufen werden.
Hinweise für Aufrufer
Wenn Logoff zurückgibt, geben Sie das Sitzungsobjekt durch Aufrufen der IUnknown::Release-Methode frei.
Weitere Informationen zum Beenden einer Sitzung finden Sie unter Beenden einer MAPI-Sitzung.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MAPIObjects.cpp |
CMapiObjects::Logoff |
MFCMAPI verwendet die IMAPISession::Logoff-Methode , um sich vor der Freigabe von der Sitzung abzumelden. |
Hinweis
Aufgrund des in Microsoft Office Outlook 2007 Service Pack 2, Microsoft Outlook 2010 und Microsoft Outlook 2013 eingeführten Schnellstartverhaltens sollten Clients den parameter MAPI_LOGOFF_SHARED niemals an IMAPISession::Logoff übergeben. Das Übergeben von MAPI_LOGOFF_SHARED führt dazu, dass alle MAPI-Clients mit dem Herunterfahren beginnen, und es kommt zu unerwartetem Verhalten.