PeerCollabAsyncInviteEndpoint 함수(p2p.h)

아티클
08/25/2023

PeerCollabAsyncInviteEndpoint 함수는 지정된 피어 엔드포인트로 초대를 보내 보낸 사람의 피어 협업 활동에 조인합니다. 초대에 대한 응답의 가용성은 비동기 이벤트를 통해 업데이트됩니다.

구문

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabAsyncInviteEndpoint(
  [in]            PCPEER_ENDPOINT   pcEndpoint,
  [in]            PCPEER_INVITATION pcInvitation,
  [in, optional]  HANDLE            hEvent,
  [out, optional] HANDLE            *phInvitation
);

매개 변수

[in] pcEndpoint

초대된 피어에 대한 정보가 포함된 PEER_ENDPOINT 구조체에 대한 포인터입니다. 이 API가 호출되면 이 피어가 초대를 보냅니다.

이 매개 변수를 NULL로 설정하면 안 됩니다.

[in] pcInvitation

pcEndpoint에 지정된 엔드포인트로 보낼 초대 요청을 포함하는 PEER_INVITATION 구조체에 대한 포인터입니다. 이 매개 변수가 NULL로 설정된 경우 E_INVALIDARG 반환됩니다.

[in, optional] hEvent

CreateEvent에 대한 이전 호출에서 만든 이 초대에 대한 이벤트를 처리합니다. 비동기 초대의 상태 업데이트될 때 이벤트가 신호를 보냅니다. 응답 데이터를 가져오려면 PeerCollabGetInvitationResponse를 호출합니다.

이벤트가 제공되지 않으면 호출자는 PeerCollabGetInvitationResponse를 호출하여 결과를 폴링해야 합니다.

[out, optional] phInvitation

보낸 초대에 대한 핸들에 대한 포인터입니다. 이 매개 변수가 NULL인 경우 프레임워크는 초대 응답을 받은 후 응답 정보를 정리합니다. 이 매개 변수가 NULL이 아니면 PeerCollabCloseHandle을 호출하여 핸들을 닫아야 합니다.

반환 값

함수가 성공하면 S_OK 반환합니다. 그렇지 않으면 함수는 다음 값 중 하나를 반환합니다.

반환 코드	설명
E_OUTOFMEMORY	이 작업을 지원하기에 충분한 메모리가 없습니다.
E_INVALIDARG	인수 중 하나가 잘못되었습니다.

설명

이 API는 입력으로 지정된 엔드포인트에 초대를 보냅니다. 초대 받는 사람이 사용자가 초대를 보내려는 특정 연락처임을 보장하지는 않습니다. 초대가 올바른 연락처로 전송되도록 하려면 PeerCollabAsyncInviteContact를 사용합니다.

초대를 받는 사람에게 알림이 표시됩니다. 이 알림은 사용자가 초대를 수락하거나 거부할 수 있는 대화 상자로 변환됩니다. 초대가 성공적으로 수락되면 받는 사람의 컴퓨터에서 공동 작업 애플리케이션이 시작됩니다.

초대를 성공적으로 받으려면 PeerCollabRegisterApplication을 사용하여 받는 사람의 컴퓨터에 애플리케이션을 등록해야 합니다. 받는 사람이 애플리케이션 초대를 해제했기 때문에 초대의 보낸 사람이 실패 코드를 반환할 수도 있습니다.

초대를 보내는 엔드포인트가 초대를 수락하지 않는 경우 PeerCollabGetInvitiationResponse 함수는 PEER_E_CONNECTION_FAILED 반환합니다.

받는 사람이 신뢰할 수 있는 연락처의 초대만 수락하는 경우 초대의 보낸 사람을 받는 사람 컴퓨터의 연락처 저장소에 추가해야 합니다. 초대를 시도하기 전에 발신자를 연락처 저장소에 추가해야 합니다. 연락처 저장소에 연락처를 추가하려면 PeerCollabAddContact를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	p2p.h
라이브러리	P2P.lib
DLL	P2P.dll