MAPILOGOFF-Rückruffunktion (mapi.h)

Artikel
08/24/2023

[Die Verwendung dieser Funktion wird abgeraten. Sie kann in nachfolgenden Versionen von Windows geändert oder nicht verfügbar sein.]

Die MAPILogoff-Funktion beendet eine Sitzung mit dem Messagingsystem.

Syntax

MAPILOGOFF Mapilogoff;

ULONG Mapilogoff(
  [in] LHANDLE lhSession,
  [in] ULONG_PTR ulUIParam,
       FLAGS flFlags,
       ULONG ulReserved
)
{...}

Parameter

[in] lhSession

Handle für die simple MAPI-Sitzung, die beendet werden soll. Sitzungshandles werden von der MAPILogon-Funktion zurückgegeben und von MAPILogoff ungültig gemacht. Der Wert des lhSession-Parameters muss eine gültige Sitzung darstellen. sie darf nicht 0 (null) sein.

[in] ulUIParam

Ziehpunkt des übergeordneten Fensters oder null, was angibt, dass es sich bei der Anzeige eines Dialogfelds um eine modale Anwendung handelt. Wenn der ulUIParam-Parameter ein übergeordnetes Fensterhandle enthält, ist er vom Typ HWND (in eine ULONG_PTR umgewandelt). Wenn während des Aufrufs kein Dialogfeld angezeigt wird, wird ulUIParam ignoriert.

flFlags

Reserviert; muss null sein.

ulReserved

Reserviert; muss null sein.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
MAPI_E_FAILURE	Der flFlags-Parameter ist ungültig, oder ein oder mehrere nicht angegebene Fehler sind aufgetreten.
MAPI_E_INSUFFICIENT_MEMORY	Es war nicht genügend Arbeitsspeicher vorhanden, um fortzufahren. Die Sitzung wurde nicht beendet.
MAPI_E_INVALID_SESSION	Für den lhSession-Parameter wurde ein ungültiges Sitzungshandle verwendet. Die Sitzung wurde nicht beendet.
SUCCESS_SUCCESS	Der Aufruf war erfolgreich, und die Sitzung wurde beendet.

Requirements (Anforderungen)


Zielplattform	Windows
Kopfzeile	mapi.h

Weitere Informationen

MAPILogon

Einfache MAPI

Freigeben über