MAPIOFFLINE_NOTIFY

適用於：Outlook 2013 |Outlook 2016

這是連線狀態變更的通知。 它會指出已變更的連接狀態部分、舊的連線狀態，以及新的連接狀態。

快速資訊

請參閱 IMAPIOfflineNotify。

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

成員

ulSize

MAPIOFFLINE_NOTIFY結構的大小。

NotifyType

通知的類型。 請注意，只支援連線狀態變更的通知;唯一支援的值為：

• MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_START
  • MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE
  • MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_DONE

ulClientToken

用戶端在 IMAPIOfflineMgr：：Advise 中MAPIOFFLINE_ADVISEINFO結構中定義的令牌。

ulMask

已變更的連接狀態部分。 唯一支援的值是 MAPIOFFLINE_STATE_OFFLINE_MASK。

ulStateOld

舊的連接狀態。 唯一支援的值為：

• MAPIOFFLINE_STATE_OFFLINE
• MAPIOFFLINE_STATE_ONLINE

ulStateNew

新的連接狀態。 唯一支援的值為：

• MAPIOFFLINE_STATE_OFFLINE
• MAPIOFFLINE_STATE_ONLINE

註解

離線狀態 API 僅支援在線/離線變更的通知。 客戶端必須先檢查 Outlook 是否傳回下列值，再檢查實際變更：

1. NotifyType 的值為 MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_START、MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE 或 MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_DONE。 在此情況下，用戶端可以假設變更是連線狀態變更，而 Info 是 StateChange 結構。

2. ulMask 的值MAPIOFFLINE_STATE_OFFLINE_MASK。 在此情況下，用戶端可以假設變更是在線/離線連線狀態變更，並可繼續檢查 ulStateOld 和 ulStateNew。

Outlook 可能會通知用戶端其他不支援的變更。 在這種情況下， NotifyType 不會是先前所述的三個值之一，或 ulMask 不會MAPIOFFLINE_STATE_OFFLINE_MASK，而且客戶端必須忽略 資訊中其餘的數據。

另請參閱

• 關於離線狀態 API
• MAPI 常數
• MAPIOFFLINE_NOTIFY_TYPE