DrtCreatePnrpBootstrapResolver 函数 (drt.h)

DrtCreatePnrpBootstrapResolver 函数基于对等名称解析协议 (PNRP) 创建启动解析程序。

语法

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

参数

[in] fPublish

如果 为 TRUE,则 pwzPeerName 中包含的并随 PNRP Bootstrap 解析程序一起传递的 PeerName 由本地 DRT 使用 PNRP 发布。 此节点可由使用 PNRP 启动提供程序的其他节点解析,并将帮助其他节点尝试启动

[in] pwzPeerName

在 PNRP 云中搜索的对等方的名称。 此字符串的最大限制为 137 个 unicode 字符

[in, optional] pwzCloudName

要搜索的与 MeshName 对应的 DRT 的云的名称。

此字符串的最大限制为 256 个 unicode 字符。 如果留空,PNRP Bootstrap 提供程序将使用所有可用的 PNRP 云。

[in, optional] pwzPublishingIdentity

发布到用于启动的 PNRP 云中的 PeerIdentity。 此字符串的最大限制为 137 个 unicode 字符。 请务必注意,如果 fPublish 设置为 TRUE,则必须允许 PublishingIdentity 发布指定的 PeerName。

[out] ppResolver

指向在 DRT_SETTINGS 结构中使用的已创建的 PNRP 启动解析程序的指针。

返回值

此函数在成功时返回S_OK。 其他可能的值包括:

返回代码 说明
E_OUTOFMEMORY
系统无法为提供程序分配内存。
E_INVALIDARG
pwzPeerName 无效。
DRT_S_RETRY
PeerPnrpStartupPeerIdentityGetCryptKey 的基础调用将返回暂时性错误。 再次尝试调用此函数。
 
注意 此函数还可能会显示对 PeerPnrpStartupPeerIdentityGetCryptKey 的基础调用返回的错误。
 

备注

此函数创建的默认 PNRP Bootstrap 解析程序特定于为其创建的 DRT。 因此,它不能在多个 DRT 之间重用。

要求

   
最低受支持的客户端 Windows 7 专业版 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 drt.h
Library Drtprov.lib
DLL Drt.dll

另请参阅

DRT_SETTINGS

DrtDeletePnrpBootstrapResolver