Skip to content

Latest commit

 

History

History
139 lines (109 loc) · 4.16 KB

nf-drt-drtcreatepnrpbootstrapresolver.md

File metadata and controls

139 lines (109 loc) · 4.16 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:drt.DrtCreatePnrpBootstrapResolver
DrtCreatePnrpBootstrapResolver function (drt.h)
DrtCreatePnrpBootstrapResolver.
DrtCreatePnrpBootstrapResolver
DrtCreatePnrpBootstrapResolver function [Peer Networking]
drt/DrtCreatePnrpBootstrapResolver
p2p.drtcreatepnrpbootstrapresolver
p2p\drtcreatepnrpbootstrapresolver.htm
p2p
5bd64f10-abb8-4cba-8ebd-780a6a0c7074
12/05/2018
DrtCreatePnrpBootstrapResolver, DrtCreatePnrpBootstrapResolver function [Peer Networking], drt/DrtCreatePnrpBootstrapResolver, p2p.drtcreatepnrpbootstrapresolver
drt.h
Windows
Windows 7 Professional [desktop apps only]
Windows Server 2008 R2 [desktop apps only]
Drtprov.lib
Drt.dll
Windows
19H1
DrtCreatePnrpBootstrapResolver
drt/DrtCreatePnrpBootstrapResolver
c++
APIRef
kbSyntax
DllExport
drt.dll
DrtCreatePnrpBootstrapResolver

DrtCreatePnrpBootstrapResolver function

-description

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

-parameters

-param fPublish [in]

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

-param pwzPeerName [in]

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

-param pwzCloudName [in, optional]

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.

-param pwzPublishingIdentity [in, optional]

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.

-param ppResolver [out]

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

-returns

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.

-see-also

DRT_SETTINGS

DrtDeletePnrpBootstrapResolver