PeerPnrpRegister 함수는 PNRP 클라우드에 피어를 등록하고 등록 업데이트에 사용할 수 있는 핸들을 반환합니다.
참고 호출될 때 이 함수는 PNRP 서비스가 시작될 때까지 차단됩니다.
구문
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpRegister(
[in] PCWSTR pcwzPeerName,
[in, optional] PPEER_PNRP_REGISTRATION_INFO pRegistrationInfo,
[out] HREGISTRATION *phRegistration
);
매개 변수
[in] pcwzPeerName
PNRP 서비스에 등록할 피어 이름을 포함하는 0으로 끝나는 유니코드 문자열에 대한 포인터입니다.
[in, optional] pRegistrationInfo
등록 피어 노드에 대한 엔드포인트 정보를 포함하는 PEER_PNRP_REGISTRATION_INFO 구조체에 대한 포인터입니다. NULL인 경우 API는 알려진 모든 PNRP 클라우드에 피어를 등록하고 등록된 주소는 인프라에서 자동으로 선택됩니다.
[out] phRegistration
호출 피어 노드에 대한 PNRP 등록에 대한 핸들입니다. 이 핸들을 사용하여 등록을 업데이트하거나 PNRP 서비스 등록을 취소합니다.
반환 값
함수 호출이 성공하면 반환 값이 S_OK. 그렇지 않으면 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
매개 변수 중 하나가 잘못되었습니다. |
|
지정된 작업을 수행할 메모리가 부족합니다. |
|
로컬 피어가 존재하지 않는 ID를 사용하고 있습니다. |
또한 이 함수는 WSA 값을 반환할 수 있습니다. 가능한 값의 전체 목록은 PNRP NSP 오류 코드를 참조하세요.
설명
핸들은 해결될 프로세스와 별도로 프로세스에 등록되어야 합니다. 핸들이 동일한 프로세스 내에서 등록되고 확인되면 인식되지 않습니다.
이름은 엔드포인트에 두 번 이상 등록할 수 없습니다. 등록된 이름에 대한 업데이트가 필요한 경우 PeerPnrpUpdateRegistration을 사용합니다.
pRegistrationInfo가 NULL이거나 cAddresses에 대해 PEER_PNRP_AUTO_ADDRESSES 지정된 경우 인프라는 주소가 변경되거나 클라우드 가용성이 변경될 때 주소를 최신 상태로 유지합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | WINDOWS XP SP2 [데스크톱 앱만 해당],Windows XP용 고급 네트워킹 팩이 있는 WINDOWS XP SP1 |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | p2p.h |
| 라이브러리 | P2P.lib |
| DLL | P2P.dll |