Freigeben über

Informationen zur Offlinestatus-API

  • Artikel

Gilt für: Outlook 2013 | Outlook 2016

Die Offlinezustands-API unterstützt Rückrufe, die Änderungen am Verbindungszustand eines Benutzers in Microsoft Outlook 2013 und Microsoft Outlook 2010 angeben, z. B. von der Online-Schaltung in Outlook 2013 oder Outlook 2010 zum Offlinemodus. Die API verwendet ein globales Offlineobjekt in Outlook 2013 oder Outlook 2010, um solche Änderungen für ein bestimmtes Benutzerkontoprofil nachzuverfolgen. Benachrichtigungen sind die einzige unterstützte Form des Rückrufs. Als Clients dieser API führen E-Mail-Anbieter, die über solche Verbindungsstatusänderungen benachrichtigt werden möchten, folgendes vor:

  1. Implementieren Sie IMAPIOfflineNotify.

  2. Öffnen Sie ein vorhandenes Offlineobjekt für ein bestimmtes Profil mithilfe von HrOpenOfflineObj.

  3. Ermitteln Sie, ob das Objekt über die Möglichkeit verfügt, Online- oder Offlinebenachrichtigungen mithilfe von IMAPIOffline::GetCapabilities bereitzustellen.

  4. Registrieren Sie das -Objekt für Online- oder Offlinebenachrichtigungen mit IMAPIOfflineMgr::Advise. E-Mail-Anbieter können jetzt Benachrichtigungen empfangen, die Outlook 2013 oder Outlook 2010 mit IMAPIOfflineNotify sendet.

  5. Entfernen Sie beim Herunterfahren die Registrierung für Online- und Offlinebenachrichtigungen mithilfe von IMAPIOfflineMgr::Unadvise.

Hinweis

Im Allgemeinen können Outlook 2013 und Outlook 2010 einen Client über Online-/Offlineänderungen sowie andere Änderungen benachrichtigen, aber die Offlinezustands-API unterstützt nur Benachrichtigungen für Online-/Offlineänderungen. Der Client sollte alle anderen Benachrichtigungen ignorieren. Weitere Informationen finden Sie unter IMAPIOfflineNotify::Notify und MAPIOFFLINE_NOTIFY.

Ein Beispiel für einen Client, der die Offlinezustands-API verwendet, finden Sie unter Informationen zum Beispiel-Offlinezustands-Add-In. Das Beispiel-Offlinezustands-Add-In ist ein COM-Add-In, das die Offlinezustands-API verwendet, um den Verbindungszustand zu überwachen und zu ändern.

Diese API bietet Folgendes:

Definitionen:

Datentypen:

Funktionen:

Schnittstellen: