PEER_GROUP_EVENT_DATA結構 (p2p.h)

發行項
03/13/2024

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	已嘗試執行未經授權的作業。例如，嘗試加入具有無效密碼的群組。