PEER_EVENT_CONNECTION_CHANGE_DATA構造体 (p2p.h)

  • [アーティクル]

PEER_GRAPH_EVENT_DATA構造体は、次のいずれかのピア イベントがトリガーされた場合に、PEER_EVENT_CONNECTION_CHANGE_DATA構造体を指します。

  • PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION
  • PEER_GRAPH_EVENT_DIRECT_CONNECTION
  • PEER_GROUP_EVENT_NEIGHBOR_CONNECTION
  • PEER_GROUP_EVENT_DIRECT_CONNECTION
PEER_EVENT_CONNECTION_CHANGE_DATA構造体には、近隣接続または直接接続への変更を含む更新された情報が含まれています。

構文

typedef struct peer_event_connection_change_data_tag {
  DWORD                  dwSize;
  PEER_CONNECTION_STATUS status;
  ULONGLONG              ullConnectionId;
  ULONGLONG              ullNodeId;
  ULONGLONG              ullNextConnectionId;
  HRESULT                hrConnectionFailedReason;
} PEER_EVENT_CONNECTION_CHANGE_DATA, *PPEER_EVENT_CONNECTION_CHANGE_DATA;

メンバー

dwSize

構造体のサイズを指定します。

status

近隣接続または直接接続での変更の種類を指定します。 有効な値は次のとおりです。

値 説明
PEER_CONNECTED
 ローカル ノードへの新しい着信または発信接続が確立されました。
PEER_CONNECTION_FAILED
 ローカル ノードへの接続が失敗しました。

接続を 1 回試行すると、複数の接続エラーが発生する可能性があります。 これは、ピア インフラストラクチャが ullNextConnectionId メンバーをノード ID に設定し、新しい接続を試行すると、最初の接続エラーの後に発生します。 ullNextConnectionId メンバーが 0 の場合、それ以上の接続は試行されません。
PEER_DISCONNECTED
 既存の接続が切断されました。

ullConnectionId

変更された接続の一意の ID を指定します。

ullNodeId

変更されたノードの一意の ID を指定します。

ullNextConnectionId

Windows Vista 以降。 グループ化またはグラフ化 API が接続に失敗したときに接続を試行する次の使用可能なノード ID が含まれます。 このメンバーの値が 0 の場合、それ以上の接続は試行されません。

hrConnectionFailedReason

Windows Vista 以降。 接続が失敗した場合のエラーの種類を指定します。 hrConnectionFailedReason は、次のエラー コードを返すことができます。

値 説明
PEER_E_CONNECTION_REFUSED 接続が確立され、拒否されました。 リモート ノードは既に最大接続数であるか、接続が既に存在します。
PEER_E_CONNECTION_FAILED リモート ノードへの接続が失敗しました。
PEER_E_CONNECTION_NOT_AUTHENTICATED 認証フェーズ中に接続が失われます。 これは、ネットワーク障害またはリモート ノードが接続を切断した結果です。

要件

   
サポートされている最小のクライアント Windows XP と SP2 [デスクトップ アプリのみ],Windows XP SP1 と Advanced Networking Pack forWindows XP
サポートされている最小のサーバー サポートなし
Header p2p.h

関連項目

PEER_GRAPH_EVENT_DATA

PEER_GROUP_EVENT_DATA