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 は前に述べた 3 つの値のいずれにもならず、 ulMask はMAPIOFFLINE_STATE_OFFLINE_MASKされず、クライアントは Info の残りのデータを無視する必要があります。

関連項目