Edit

Share via

DrtCreatePnrpBootstrapResolver function (drt.h)

  • Article

The DrtCreatePnrpBootstrapResolver function creates a bootstrap resolver based on the Peer Name Resolution Protocol (PNRP).

Syntax

HRESULT DrtCreatePnrpBootstrapResolver(
  [in]           BOOL                   fPublish,
  [in]           PCWSTR                 pwzPeerName,
  [in, optional] PCWSTR                 pwzCloudName,
  [in, optional] PCWSTR                 pwzPublishingIdentity,
  [out]          DRT_BOOTSTRAP_PROVIDER **ppResolver
);

Parameters

[in] fPublish

If TRUE, the PeerName contained in pwzPeerName and passed with the PNRP Bootstrap Resolver is published by the local DRT using PNRP. This node will be resolvable by other nodes using the PNRP bootstrap provider, and will assist other nodes attempting to bootstrap

[in] pwzPeerName

The name of the peer to search for in the PNRP cloud. This string has a maximum limit of 137 unicode characters

[in, optional] pwzCloudName

The name of the cloud to search for in for the DRT corresponding to the MeshName.

This string has a maximum limit of 256 unicode characters. If left blank the PNRP Bootstrap Provider will use all PNRP clouds available.

[in, optional] pwzPublishingIdentity

The PeerIdentity that is publishing into the PNRP cloud utilized for bootstrapping. This string has a maximum limit of 137 unicode characters. It is important to note that if fPublish is set to TRUE, the PublishingIdentity must be allowed to publish the PeerName specified.

[out] ppResolver

A pointer to the created PNRP bootstrap resolver which is used in the DRT_SETTINGS structure.

Return value

This function returns S_OK on success. Other possible values include:

Return code Description
E_OUTOFMEMORY
 The system cannot allocate memory for the provider.
E_INVALIDARG
 pwzPeerName is invalid.
DRT_S_RETRY
 Underlying calls to PeerPnrpStartup or PeerIdentityGetCryptKey return a transient error. Try calling this function again.
 
Note  This function may also surface errors returned by underlying calls to PeerPnrpStartup or PeerIdentityGetCryptKey.
 

Remarks

The default PNRP Bootstrap Resolver created by this function is specific to the DRT it is created for. As a result it cannot be re-used across multiple DRTs.

Requirements

Requirement Value
Minimum supported client Windows 7 Professional [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header drt.h
Library Drtprov.lib
DLL Drt.dll

See also

DRT_SETTINGS

DrtDeletePnrpBootstrapResolver