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 ブートストラップ リゾルバーと共に渡された 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

DRT_SETTINGS構造体で使用される、作成された PNRP ブートストラップ リゾルバーへのポインター。

戻り値

この関数は、成功したS_OKを返します。 その他の可能な値は次のとおりです。

リターン コード 説明
E_OUTOFMEMORY
 システムは、プロバイダーにメモリを割り当てることができません。
E_INVALIDARG
 pwzPeerName が無効です。
DRT_S_RETRY
 PeerPnrpStartup または PeerIdentityGetCryptKey の基になる呼び出しでは、一時的なエラーが返されます。 この関数をもう一度呼び出してみてください。
 
メモ この関数は、 PeerPnrpStartup または PeerIdentityGetCryptKey の基になる呼び出しによって返されるエラーを表示することもできます。
 

解説

この関数によって作成される既定の PNRP ブートストラップ リゾルバーは、作成対象の DRT に固有です。 その結果、複数の DRT 間で再利用することはできません。

要件

   
サポートされている最小のクライアント Windows 7 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー drt.h
Library Drtprov.lib
[DLL] Drt.dll

関連項目

DRT_SETTINGS

DrtDeletePnrpBootstrapResolver