PeerCollabInviteContact 함수(p2p.h)
PeerCollabInviteContact 함수는 피어 협업 활동을 신뢰할 수 있는 연락처에 조인하는 초대를 보냅니다. 이 호출은 동기적이며, 성공하면 연락처로부터 응답을 얻습니다.
구문
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabInviteContact(
[in] PCPEER_CONTACT pcContact,
[in] PCPEER_ENDPOINT pcEndpoint,
[in] PCPEER_INVITATION pcInvitation,
[out] PPEER_INVITATION_RESPONSE *ppResponse
);
매개 변수
[in] pcContact
초대 대상과 연결된 연락처 정보를 포함하는 PEER_CONTACT 구조체에 대한 포인터입니다.
[in] pcEndpoint
초대된 피어에 대한 정보가 포함된 PEER_ENDPOINT 구조체에 대한 포인터입니다. 이 API가 호출되면 이 피어가 초대를 보냅니다.
[in] pcInvitation
pcEndpoint에 지정된 엔드포인트로 보낼 초대 요청을 포함하는 PEER_INVITATION 구조체에 대한 포인터입니다. 이 매개 변수를 NULL로 설정하면 안 됩니다.
[out] ppResponse
초대 요청에 대한 초대된 피어 엔드포인트의 응답을 수신하는 PEER_INVITATION_RESPONSE 구조체에 대한 포인터입니다.
오류와 함께 이 호출이 실패하면 이 매개 변수는 NULL이 됩니다.
PeerFreeData를 호출하여 반환된 메모리를 해제합니다.
반환 값
함수가 성공하면 S_OK 반환합니다. 그렇지 않으면 함수는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
이 작업을 지원하기에 충분한 메모리가 없습니다. |
|
인수 중 하나가 잘못되었습니다. |
|
초대 수신자가 5분 이내에 응답하지 않았습니다. |
설명
이 API는 초대를 받는 피어가 입력으로 지정된 연락처인지 확인합니다. 지정된 엔드포인트에 특정 연락처가 없으면 연결이 실패합니다. 덜 안전한 PeerCollabInviteEndpoint 대신 PeerCollabInviteContact를 사용하는 것이 좋습니다.
초대를 받는 사람에게 알림이 표시됩니다. 이 알림은 사용자가 초대를 수락하거나 거부할 수 있는 대화 상자로 변환됩니다. 초대가 성공적으로 수락되면 받는 사람의 컴퓨터에서 공동 작업 애플리케이션이 시작됩니다.
초대를 성공적으로 받으려면 PeerCollabRegisterApplication을 사용하여 받는 사람의 컴퓨터에 애플리케이션을 등록해야 합니다. 받는 사람이 애플리케이션 초대를 해제했기 때문에 초대의 보낸 사람이 실패 코드를 반환할 수도 있습니다.
받는 사람이 신뢰할 수 있는 연락처의 초대만 수락하는 경우 초대의 보낸 사람을 받는 사람 컴퓨터의 연락처 저장소에 추가해야 합니다. 초대를 시도하기 전에 발신자를 연락처 저장소에 추가해야 합니다. 연락처 저장소에 연락처를 추가하려면 PeerCollabAddContact를 호출합니다.
시간 제한을 방지하려면 초대 수신자가 5분 이내에 응답해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| 헤더 | p2p.h |
| 라이브러리 | P2P.lib |
| DLL | P2P.dll |