PeerPnrpUpdateRegistration function (p2p.h)

  • Article

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

See also

PeerPnrpRegister

PeerPnrpUnregister