Freigeben über

MAPIOFFLINE_NOTIFY

  • Artikel

Gilt für: Outlook 2013 | Outlook 2016

Dies ist die Benachrichtigung für eine Änderung des Verbindungszustands. Es gibt den Teil des Verbindungszustands an, der sich geändert hat, den alten Verbindungszustand und den neuen Verbindungszustand.

QuickInfo

Siehe IMAPIOfflineNotify.

typedef struct  
{ 
      ULONG ulSize; 
      MAPIOFFLINE_NOTIFY_TYPE NotifyType; 
      ULONG ulClientToken; 
      union { 
         struct 
           { 
           ULONG ulMask; 
           ULONG ulStateOld; 
           ULONG ulStateNew; 
           } StateChange; 
             } Info; 
} MAPIOFFLINE_NOTIFY;

Members

ulSize

Größe der MAPIOFFLINE_NOTIFY-Struktur .

NotifyType

Typ der Benachrichtigung. Beachten Sie, dass nur Benachrichtigungen bei Änderung des Verbindungszustands unterstützt werden. die einzigen unterstützten Werte sind:

  • MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_START
    • MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE
    • MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_DONE

ulClientToken

Ein Vom Client in der MAPIOFFLINE_ADVISEINFO-Struktur in IMAPIOfflineMgr::Advise definiertes Token.

ulMask

Der Teil des Verbindungszustands, der sich geändert hat. Der einzige unterstützte Wert ist MAPIOFFLINE_STATE_OFFLINE_MASK.

ulStateOld

Der alte Verbindungszustand. Die einzigen unterstützten Werte sind:

  • MAPIOFFLINE_STATE_OFFLINE
  • MAPIOFFLINE_STATE_ONLINE

ulStateNew

Der neue Verbindungsstatus. Die einzigen unterstützten Werte sind:

  • MAPIOFFLINE_STATE_OFFLINE
  • MAPIOFFLINE_STATE_ONLINE

Hinweise

Die Offlinezustands-API unterstützt nur Benachrichtigungen für Online-/Offlineänderungen. Ein Client muss überprüfen, ob Outlook die folgenden Werte zurückgibt, bevor die tatsächliche Änderung untersucht wird:

  1. NotifyType hat den Wert MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_START, MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE oder MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_DONE. In diesem Fall kann der Client davon ausgehen, dass es sich bei der Änderung um eine Änderung des Verbindungszustands handelt, und Info ist der Struktur StateChange.

  2. ulMask hat den Wert MAPIOFFLINE_STATE_OFFLINE_MASK. In diesem Fall kann der Client davon ausgehen, dass es sich bei der Änderung um eine Änderung des Online-/Offline-Verbindungszustands handelt, und kann mit der Untersuchung von ulStateOld und ulStateNew fortfahren.

Es ist möglich, dass Outlook einen Client über andere Änderungen benachrichtigt, die nicht unterstützt werden. In solchen Fällen wäre NotifyType keiner der drei zuvor angegebenen Werte, oder ulMask wäre nicht MAPIOFFLINE_STATE_OFFLINE_MASK, und der Client muss die restlichen Daten in Info ignorieren.

Siehe auch