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;

Members

ulSize

MAPIOFFLINE_NOTIFY结构的大小。

NotifyType

通知类型。 请注意，仅支持有关连接状态更改的通知;唯一支持的值是：

• MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_START
  • MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE
  • MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_DONE

ulClientToken

由客户端在 IMAPIOfflineMgr：：AdviseMAPIOFFLINE_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。 在这种情况下，客户端可以假定更改是连接状态更改， 并且信息 是 结构 StateChange。

2. ulMask 具有值MAPIOFFLINE_STATE_OFFLINE_MASK。 在这种情况下，客户端可以假定更改是联机/脱机连接状态更改，并且可以继续检查 ulStateOld 和 ulStateNew。

Outlook 可能会通知客户端其他不支持的更改。 在这种情况下， NotifyType 不会是前面所述的三个值中的任何一个，或者 ulMask 不会MAPIOFFLINE_STATE_OFFLINE_MASK，并且客户端必须忽略 Info 中的其余数据。

另请参阅

• 关于脱机状态 API
• MAPI 常量
• MAPIOFFLINE_NOTIFY_TYPE