PEER_GROUP_EVENT_DATA 结构 (p2p.h)

项目
08/25/2023

PEER_GROUP_EVENT_DATA结构包含有关已发生的特定对等组事件的信息。

语法

typedef struct peer_group_event_data_tag {
  PEER_GROUP_EVENT_TYPE eventType;
  union {
    PEER_GROUP_STATUS                 dwStatus;
    PEER_EVENT_INCOMING_DATA          incomingData;
    PEER_EVENT_RECORD_CHANGE_DATA     recordChangeData;
    PEER_EVENT_CONNECTION_CHANGE_DATA connectionChangeData;
    PEER_EVENT_MEMBER_CHANGE_DATA     memberChangeData;
    HRESULT                           hrConnectionFailedReason;
  };
} PEER_GROUP_EVENT_DATA, *PPEER_GROUP_EVENT_DATA;

成员

eventType

PEER_GROUP_EVENT_TYPE 枚举值，该值指定发生的对等组事件的类型。事件的类型决定了从联合中选择的后续结构;例如，如果此值设置为 PEER_GROUP_EVENT_INCOMING_DATA，则填充的联合成员为 incomingData。

dwStatus

指定指示对等组新状态的PEER_GROUP_STATUS 标志值。如果引发PEER_GROUP_EVENT_STATUS_CHANGED事件，则填充此字段。

incomingData

指定包含来自对等方传入数据的信息的PEER_EVENT_INCOMING_DATA 结构。如果引发PEER_GROUP_EVENT_INCOMING_DATA事件，则填充此结构。

recordChangeData

指定包含描述记录更改的数据的PEER_EVENT_RECORD_CHANGE_DATA 结构。如果引发PEER_GROUP_EVENT_RECORD_CHANGED事件，则会填充此结构。

connectionChangeData

PEER_EVENT_CONNECTION_CHANGE_DATA 结构，在直接连接或邻居连接发生更改时包含信息。如果引发PEER_GROUP_EVENT_DIRECT_CONNECTION或PEER_GROUP_EVENT_NEIGHBOR_CONNECTION事件，则会填充此结构。

memberChangeData

PEER_EVENT_MEMBER_CHANGE_DATA 结构，当对等组成员的状态发生更改时包含数据。如果引发PEER_GROUP_EVENT_MEMBER_CHANGED事件，则填充此结构。

hrConnectionFailedReason

指示发生的连接失败类型的 HRESULT。如果引发PEER_GROUP_EVENT_CONNECTION_FAILED事件，则填充此值。此值为下列值之一：

值	含义
PEER_E_NO_MEMBERS_FOUND	找不到要连接到的对等组中的可用对等方。
PEER_E_NO_MEMBER_CONNECTIONS	没有可用的成员连接。
PEER_E_UNABLE_TO_LISTEN	由于未指定的原因，对等方无法接收连接数据。
PEER_E_NOT_AUTHORIZED	已尝试执行未经授权的操作。例如，尝试使用无效密码加入组。