PeerPnrpResolve 함수(p2p.h)

PeerPnrpResolve 함수는 특정 피어 이름에 대해 등록된 엔드포인트 주소를 가져옵니다.

구문

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpResolve(
  [in]           PCWSTR                   pcwzPeerName,
  [in, optional] PCWSTR                   pcwzCloudName,
  [in, out]      ULONG                    *pcEndpoints,
  [out]          PPEER_PNRP_ENDPOINT_INFO *ppEndpoints
);

매개 변수

[in] pcwzPeerName

엔드포인트 주소를 가져올 피어 이름을 포함하는 0으로 끝나는 문자열에 대한 포인터입니다.

[in, optional] pcwzCloudName

피어 이름을 resolve PNRP 클라우드의 이름을 포함하는 0으로 끝나는 문자열에 대한 포인터입니다. NULL이면 모든 클라우드에서 resolve 수행됩니다. PEER_PNRP_ALL_LINK_CLOUDS 경우 모든 링크 로컬 클라우드에서 resolve 수행됩니다. "GLOBAL_"이면 resolve 전역 클라우드에서만 수행됩니다.

[in, out] pcEndpoints

ppEndpoints에서 반환할 최대 엔드 포인트 수입니다. 반환 시 이 매개 변수에는 ppEndpoints의 실제 엔드포인트 수가 포함됩니다.

[out] ppEndpoints

피어 이름이 성공적으로 확인된 엔드포인트를 포함하는 PEER_PNRP_ENDPOINT_INFO 구조 목록의 포인터입니다. 각 엔드포인트에는 피어 노드에 연결할 수 있는 하나 이상의 IP 주소가 포함되어 있습니다.

반환 값

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

설명

이 호출은 동기적이며 완료될 때까지 차단됩니다. 비동기 피어 이름 확인을 위해 PeerPnrpStartResolve를 호출하고 제공된 이벤트가 발생할 때 확인된 엔드포인트 주소를 가져옵니다.

핸들은 등록된 프로세스와 별도로 프로세스에서 확인되어야 합니다. 핸들이 등록되고 동일한 프로세스 내에서 확인되면 인식되지 않습니다.

모든 클라우드에 대해 해결이 수행되면 각 클라우드에 동시에 발급됩니다. 메서드는 클라우드 조합에서 충분한 결과를 받은 즉시 반환됩니다.

이 메서드에서 내부적으로 사용되는 기본 resolve 시간 제한은 30초입니다. 특정 시간 제한이 필요한 경우 비동기 PeerPnrpStartResolve 함수를 사용해야 합니다.

요구 사항

추가 정보

PeerPnrpStartResolve