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 中包含的 PeerName ，並使用 PNRP 啟動程式解析程式傳遞的 PeerName 會由使用 PNRP 的本機 DRT 發佈。 使用 PNRP 啟動程式提供者的其他節點可解析此節點，並協助其他節點嘗試啟動程式

[in] pwzPeerName

在 PNRP 雲端中搜尋的對等名稱。 此字串的最大限制為 137 個 unicode 字元

[in, optional] pwzCloudName

要搜尋的雲端名稱，以尋找對應至 MeshName 的 DRT。

此字串的最大限制為 256 個 unicode 字元。 如果保留空白，PNRP 啟動程式提供者將會使用所有可用的 PNRP 雲端。

[in, optional] pwzPublishingIdentity

發佈至用於啟動載入的 PNRP 雲端的 PeerIdentity。 此字串的最大限制為 137 個 Unicode 字元。 請務必注意，如果 fPublish 設定為 TRUE，則必須允許 PublishingIdentity 發佈指定的 PeerName。

[out] ppResolver

所建立 PNRP 啟動程式解析程式的指標，用於 DRT_SETTINGS 結構。

傳回值

此函式會在成功時傳回S_OK。 其他可能的值包括：

傳回碼 描述
E_OUTOFMEMORY
 系統無法為提供者配置記憶體。
E_INVALIDARG
 pwzPeerName 無效。
DRT_S_RETRY
 對 PeerPnrpStartup或PeerIdentityGetCryptKey的基礎呼叫會傳回暫時性錯誤。 再次嘗試呼叫此函式。
 
注意 此函式也可能顯示 基礎對 PeerPnrpStartup 或 PeerIdentityGetCryptKey所傳回的錯誤。
 

備註

此函式所建立的預設 PNRP 啟動程式解析程式專屬於其建立的 DRT。 因此，無法在多個 DRT 之間重複使用。

需求

   
最低支援的用戶端 Windows 7 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 drt.h
程式庫 Drtprov.lib
Dll Drt.dll

另請參閱

DRT_SETTINGS

DrtDeletePnrpBootstrapResolver