PeerCollabAsyncInviteContact 함수(p2p.h)

아티클
08/25/2023

PeerCollabAsyncInviteContact 함수는 신뢰할 수 있는 피어 연락처에 초대를 보내 보안 연결을 통해 보낸 사람의 피어 협업 활동에 조인합니다. 초대 응답의 가용성은 비동기 이벤트를 통해 업데이트됩니다.

구문

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabAsyncInviteContact(
  [in, optional] PCPEER_CONTACT    pcContact,
  [in]           PCPEER_ENDPOINT   pcEndpoint,
  [in]           PCPEER_INVITATION pcInvitation,
  [in, optional] HANDLE            hEvent,
  [optional]     HANDLE            *phInvitation
);

매개 변수

[in, optional] pcContact

초대 받는 사람과 연결된 연락처 정보를 포함하는 PEER_CONTACT 구조체에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다.

pcEndpoint에 지정된 호출 피어의 엔드포인트를 초대하려면 포인터 값을 NULL로 설정합니다.

[in] pcEndpoint

초대된 피어의 엔드포인트에 대한 정보가 포함된 PEER_ENDPOINT 구조체에 대한 포인터입니다. 엔드포인트는 pcContact에 지정된 피어 연락처와 연결되어야 합니다.

[in] pcInvitation

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

[in, optional] hEvent

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

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

[optional] phInvitation

보낸 초대에 대한 핸들에 대한 포인터입니다. 프레임워크는 NULL이 지정된 경우 초대 응답을 받은 후 응답 정보를 정리합니다. NULL이 제공된 초대에 대해 지정된 핸들이 아닌 경우 PeerCollabCloseHandle을 호출하여 닫아야 합니다.

반환 값

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

반환 코드	설명
E_OUTOFMEMORY	이 작업을 지원하기에 충분한 메모리가 없습니다.
E_INVALIDARG	인수 중 하나가 잘못되었습니다.
E_NOTIMPL	pcEndpoint 가 NULL입니다.
PEER_E_NOT_INITIALIZED	Windows 피어 인프라가 초기화되지 않았습니다. 관련 초기화 함수를 호출해야 합니다.

설명

이 API는 초대를 받는 피어가 입력으로 지정된 연락처인지 확인합니다. 지정된 엔드포인트에 특정 연락처가 없으면 연결이 실패합니다. 덜 안전한 PeerCollabAsyncInviteEndpoint 대신 PeerCollabAsyncInviteContact를 사용하는 것이 좋습니다.

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

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

초대를 보내는 연락처가 초대를 수락하지 않는 경우 PeerCollabGetInvitiationResponse 함수는 PEER_E_CONNECTION_FAILED 반환합니다.

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

미해결 초대를 취소하려면 PeerCollabCancelInvitation을 호출합니다.

요구 사항

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