IXPLogon::TransportLogoff
Gilt für: Outlook 2013 | Outlook 2016
Initiiert den Abmeldungsprozess.
HRESULT TransportLogoff(
ULONG ulFlags
);
Parameter
ulFlags
[in] Reserviert. NULL muss sein.
Rückgabewert
S_OK
Der Aufruf war erfolgreich und hat den erwarteten Wert oder die erwarteten Werte zurückgegeben. Wenn etwas anderes als S_OK zurückgegeben wird, wird der Anbieter abgemeldet.
Hinweise
Der MAPI-Spooler ruft die IXPLogon::TransportLogoff-Methode auf, um eine Transportanbietersitzung für einen bestimmten Benutzer zu beenden. Vor dem Aufrufen von TransportLogoff verwirft der MAPI-Spooler alle Daten zu unterstützten Messagingadresstypen für diese Sitzung, die in der IXPLogon::AddressTypes-Methode übergeben werden.
Hinweise für Implementierer
Der Transportanbieter sollte bereit sein, jederzeit einen Aufruf von TransportLogoff anzunehmen. Wenn eine Nachricht gerade verarbeitet wird, sollte der Anbieter den Sendevorgang beenden.
Der Transportanbieter sollte alle Ressourcen freigeben, die für seine aktuelle Sitzung zugeordnet sind. Wenn arbeitsspeicher für diese Sitzung mit der MAPIAllocateBuffer-Funktion zugewiesen wurde, sollte der Arbeitsspeicher mithilfe der MAPIFreeBuffer-Funktion freigegeben werden. Jeder speicher, der vom Transportanbieter zum Erfüllen von Aufrufen der IXPLogon::AddressTypes-Methode zugeordnet wird, kann zu diesem Zeitpunkt sicher freigegeben werden.
In der Regel sollte ein Anbieter nach Abschluss eines TransportLogoff-Aufrufs zunächst sein Anmeldeobjekt durch Aufrufen der IMAPISupport::MakeInvalid-Methode für ungültig erklären und dann sein Supportobjekt freigeben. Die Implementierung von TransportLogoff des Anbieters sollte das Supportobjekt zuletzt freigeben, denn wenn das Supportobjekt freigegeben wird, kann der MAPI-Spooler auch das Anbieterobjekt selbst freigeben.