Herunterfahren eines Dienstanbieters
Gilt für: Outlook 2013 | Outlook 2016
Wenn ein Client die IMAPISession::Logoff-Methode aufruft, um die Sitzung zu beenden und alle aktiven Dienstanbieter herunterzufahren, ruft MAPI wiederum die folgenden Methoden auf:
IABLogon::Logoff für Adressbuchanbieter.
IMSLogon::Logoff für Nachrichtenspeicheranbieter.
IXPLogon::TransportLogoff für Transportanbieter.
Diese Methoden weisen ähnliche Implementierungen auf. Die Standard Aufgaben, die eine Abmeldungsmethode ausführt, sind wie folgt:
Alle geöffneten Objekte werden freigegeben, einschließlich Unterobjekten und status-Objekten.
Aufrufen der IUnknown::Release-Methode des Supportobjekts, um die Verweisanzahl zu verringern.
Entfernen aller registrierten MAPIUID-Strukturen Ihres Anbieters.
Entfernen der Zeile Ihres Anbieters in der status Tabelle.
Ausführen von Aufgaben, die sich auf das Bereinigen von Ressourcen beziehen, z. B. die folgenden:
Beenden einer Verbindung mit einem Remoteserver.
Verringern der Verweisanzahl für das Anmeldeobjekt.
Entfernen des Anmeldeobjekts aus der Liste der Anmeldeobjekte, die Ihr Anbieter speichert.
Im Debugmodus werden Ablaufverfolgungen ausgegeben, um Objekte zu finden, die arbeitsspeicherverlusten.
Wenn die Abmeldungsmethode zurückgegeben wird, ruft MAPI Folgendes auf:
Die IUnknown::Release-Methode Ihres Anmeldeobjekts.
Die Shutdown-Methode Ihres Anbieterobjekts, um alle abschließenden Bereinigungsaufgaben auszuführen. Abhängig vom Typ Ihres Anbieters wird eine der folgenden Methoden aufgerufen:
IABProvider::Shutdown für Adressbuchanbieter
IMSProvider::Shutdown für Nachrichtenspeicheranbieter
IXPProvider::Shutdown für Transportanbieter
Die IUnknown::Release-Methode Ihres Anbieterobjekts.
Wenn Es sich bei Ihrem Anbieter um einen Nachrichtenspeicher handelt, wird durch einen Clientaufruf von IMsgStore::StoreLogoff auch das Herunterfahren initiiert. StoreLogoff beendet einen bestimmten Nachrichtenspeicheranbieter und hat keine Auswirkungen auf die Sitzung. Mit dieser Methode kann nur ein Nachrichtenspeicheranbieter heruntergefahren werden. es gibt keine explizite Möglichkeit zum Herunterfahren eines bestimmten Adressbuchs oder Transportanbieters. Informationen zum Reagieren auf einen StoreLogoff-Aufruf finden Sie unter Herunterfahren eines Nachrichtenspeicheranbieters.
Die DLL Ihres Anbieters wird entladen, wenn MAPI die Win32-API-Funktion FreeLibrary aufruft, ein Aufruf, der erfolgt, nachdem der letzte aktive Client MAPIUninitialize aufgerufen hat. Bis zu diesem Zeitpunkt ist das Herunterfahren Ihres Dienstanbieters abgeschlossen.