PeerGroupConnect 함수(p2p.h)

PeerGroupConnect 함수는 피어 그룹에 대한 PNRP 검색을 시작하고 연결을 시도합니다. 이 함수가 성공적으로 호출되면 피어는 피어 그룹의 다른 멤버와 통신할 수 있습니다.

구문

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnect(
  [in] HGROUP hGroup
);

매개 변수

[in] hGroup

피어가 연결하려는 피어 그룹에 대한 핸들입니다. 이 핸들은 PeerGroupCreate, PeerGroupOpen, PeerGroupJoin 또는 PeerGroupPasswordJoin 함수에 의해 반환됩니다. 이 매개 변수는 필수입니다.

반환 값

작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 함수는 다음 값을 반환합니다.

반환 코드	설명
PEER_E_INVALID_GROUP	피어 그룹에 대한 핸들이 잘못되었습니다.

 

암호화 관련 오류는 Microsoft RSA 기본 공급자에서 반환할 수 있습니다. 이러한 오류는 CRYPT_*로 접두사로 지정되고 Winerror.h에 정의됩니다.

설명

애플리케이션은 이 함수를 호출하기 전에 피어 이벤트를 등록합니다. 함수 호출에 실패하면 PEER_GROUP_EVENT_CONNECTION_FAILED 이벤트가 발생합니다. 그렇지 않으면 PEER_GROUP_EVENT_STATUS_CHANGED 이벤트가 발생합니다.

PEER_GROUP_EVENT_CONNECTION_FAILED 이벤트는 그룹 작성자가 만든 직후 PeerGroupConnect 를 호출하지 못할 때도 발생합니다. 이 작업을 수행하지 않으면 초대를 받은 사용자는 PeerGroupConnect 를 성공적으로 호출하지만 수신 대기할 수 없으며 결국 연결 실패 이벤트를 받게 됩니다.

참여하는 컴퓨터 간에 클록 기울이기의 경우 PeerGroupConnect 의 성공은 기울이기의 심각도에 따라 달라질 수 있습니다. 조인 실패 문제를 해결할 때는 컴퓨터 시계가 동기화되었는지 확인하여 이러한 가능성을 고려해야 합니다.

피어 그룹에 있고 이벤트를 수신하지만 연결되지 않은 상태로 유지하려면 PeerGroupOpen 함수를 사용합니다.

애플리케이션에 PeerGroupConnect에 대한 제한 시간 값이 제공되지 않으면 오류가 발생하면 애플리케이션이 중단됩니다. 제한 시간 값은 30초입니다.

PeerGroupConnect를 호출하기 전에 그룹이 '연결 끊어진 상태'에 있습니다. 이 시간 동안 그룹을 검색하거나 연결을 받을 수 없습니다. 그룹을 이 상태로 되돌리려면 PeerGroupClose 함수를 호출해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2 [데스크톱 앱만 해당],Windows XP SP1 및 고급 네트워킹 팩 forWindows XP
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	p2p.h
라이브러리	P2P.lib
DLL	P2P.dll

추가 정보

PeerGroupClose

PeerGroupJoin

PeerGroupOpen

PeerGroupPasswordJoin