PEER_GROUP_EVENT_DATA 구조체(p2p.h)

아티클
03/01/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	권한 없는 작업을 수행하려고 했습니다. 예를 들어 잘못된 암호를 사용하여 그룹에 가입하려고 시도합니다.