PeerCollabRefreshEndpointData 함수(p2p.h)
PeerCollabRefreshEndpointData 함수는 호출 피어 노드를 새 엔드포인트 데이터로 업데이트합니다.
구문
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRefreshEndpointData(
[in] PCPEER_ENDPOINT pcEndpoint
);
매개 변수
[in] pcEndpoint
현재 피어 노드에 대한 업데이트된 피어 엔드포인트 정보를 포함하는 PEER_ENDPOINT 구조체에 대한 포인터입니다.
반환 값
함수가 성공하면 S_OK 반환합니다. 그렇지 않으면 함수는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
이 작업을 지원하기에 충분한 메모리가 없습니다. |
|
인수 중 하나가 잘못되었습니다. |
설명
PeerCollabRefreshEndpointData 를 사용하면 애플리케이션이 엔드포인트와 연결된 데이터를 새로 고칠 수 있습니다. API가 완료되면 PEER_EVENT_REQUEST_STATUS_CHANGED 이벤트가 발생합니다. 이벤트에 성공 또는 실패 코드가 포함됩니다.
성공하면 애플리케이션은 PeerCollabGetPresenceInfo, PeerCollabEnumApplications, PeerCollabEnumObjects 및 PeerCollabQueryContactData 와 같은 함수를 호출하여 추가 데이터를 가져올 수 있습니다. 데이터가 더 이상 필요하지 않은 경우 PeerCollabDeleteEndpointData를 호출하여 데이터를 삭제할 수 있습니다.
피어가 엔드포인트를 구독하는 경우 구독된 데이터는 PeerCollabRefreshEndpointDataand를 호출하여 캐시된 데이터보다 더 높은 우선 순위를 가지며 PEER_EVENT_REQUEST_STATUS_CHANGED 반환합니다.
PeerCollabRefreshEndpointData API는 지정된 엔드포인트에 대한 데이터의 스냅샷 사용합니다. 이 스냅샷 수행한 후 엔드포인트 데이터가 변경되면 호출자에게 데이터의 부실 복사본이 있습니다. PeerCollabRefreshEndpointData가 동일한 엔드포인트에 대해 애플리케이션에서 여러 번 호출되는 경우 수신된 최신 데이터는 API에 대한 이전 호출에서 저장된 데이터를 대체합니다. 그러나 호출자에게 변경 내용에 대한 알림을 받고 항상 최신 복사본이 있는지 확인하려면 PeerCollabRefreshEndpointData 대신 PeerCollabSubscribeEndpointData를 사용하는 것이 좋습니다.
PeerCollabRefreshEndpointData 함수의 시간 제한은 30초입니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| 헤더 | p2p.h |
| 라이브러리 | P2P.lib |
| DLL | P2P.dll |