PeerPnrpUpdateRegistration function (p2p.h)

Article
02/22/2024

The PeerPnrpUpdateRegistration function updates the PNRP registration information for a name.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpUpdateRegistration(
  [in] HREGISTRATION                hRegistration,
  [in] PPEER_PNRP_REGISTRATION_INFO pRegistrationInfo
);

Parameters

[in] hRegistration

Handle to a PNRP registration for the peer node obtained by a previous call to PeerPnrpRegister.

[in] pRegistrationInfo

Pointer to a PEER_PNRP_REGISTRATION_INFO structure that contains the endpoint information for the registering peer node.

Return value

If the function call succeeds, the return value is S_OK. Otherwise, it returns one of the following values.

Return code	Description
E_INVALIDARG	One of the parameters is not valid.
E_OUTOFMEMORY	There is not enough memory to perform the specified operation.

Remarks

The pwzCloudName and cAddresses members of the PEER_PNRP_REGISTRATION_INFO provided in the pRegistrationInfo parameter cannot be changed with PeerPnrpUpdateRegistration. Attempting to do so will return an E_INVALIDARG error.

PeerPnrpUpdateRegistration has a maximum payload of 4k.

Requirements

Requirement	Value
Minimum supported client	Windows XP with SP2 [desktop apps only],Windows XP with SP1 with the Advanced Networking Pack for Windows XP
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	p2p.h
Library	P2P.lib
DLL	P2P.dll