PeerCollabQueryContactData 함수(p2p.h)
PeerCollabQueryContactData 함수는 제공된 피어 엔드포인트에 대한 연락처 정보를 검색합니다.
구문
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabQueryContactData(
[in, optional] PCPEER_ENDPOINT pcEndpoint,
[out] PWSTR *ppwzContactData
);
매개 변수
[in, optional] pcEndpoint
연락처 정보를 가져올 피어 엔드포인트가 포함된 PEER_ENDPOINT 구조체에 대한 포인터입니다.
이 매개 변수를 NULL로 설정하면 현재 피어 엔드포인트에 대한 연락처 정보를 가져옵니다.
[out] ppwzContactData
pcEndpoint에 제공된 엔드포인트에 대한 연락처 데이터를 포함하는 0으로 끝나는 유니코드 문자열 버퍼에 대한 포인터입니다. PeerFreeData를 호출하여 데이터를 해제합니다.
반환 값
함수가 성공하면 S_OK 반환합니다. 그렇지 않으면 함수는 다음 값 중 하나를 반환합니다.
반환 코드 | 설명 |
---|---|
|
이 작업을 지원하기에 충분한 메모리가 없습니다. |
|
인수 중 하나가 잘못되었습니다. |
|
요청된 연락처 데이터가 없습니다. 다른 시도를 하기 전에 PeerCollabRefreshEndpointData 를 호출해 보세요. |
설명
엔드포인트에 대한 연락처 데이터를 성공적으로 검색하려면 다음 중 하나가 발생해야 합니다.
- 이전에 PeerCollabEnumEndpoints를 호출하여 엔드포인트를 얻었어야 합니다.
- 로컬 피어는 PeerCollabSubscribeEndpointData를 호출하여 엔드포인트를 구독해야 합니다.
- PeerCollabRefreshEndpointData를 성공적으로 호출하여 엔드포인트 데이터를 새로 고쳐야 합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
지원되는 최소 서버 | 지원되는 버전 없음 |
대상 플랫폼 | Windows |
헤더 | p2p.h |
라이브러리 | P2P.lib |
DLL | P2P.dll |