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	로컬 노드에 연결하지 못했습니다. 연결을 한 번의 시도로 인해 여러 연결 오류가 발생할 수 있습니다. 이는 피어 인프라가 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 및 고급 네트워킹 팩 forWindows XP
지원되는 최소 서버	지원되는 버전 없음
머리글	p2p.h

추가 정보

PEER_GRAPH_EVENT_DATA

PEER_GROUP_EVENT_DATA