DrtCreatePnrpBootstrapResolver-Funktion (drt.h)

Artikel
08/23/2023

Die DrtCreatePnrpBootstrapResolver-Funktion erstellt einen Bootstrapresolver basierend auf dem 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
);

Parameter

[in] fPublish

Wenn TRUE, wird der peerName, der in pwzPeerName enthalten und mit dem PNRP Bootstrap Resolver übergeben wird, vom lokalen DRT mithilfe von PNRP veröffentlicht. Dieser Knoten kann von anderen Knoten aufgelöst werden, die den PNRP-Bootstrap-Anbieter verwenden, und unterstützt andere Knoten beim Bootstrap-Versuch.

[in] pwzPeerName

Der Name des Peers, nach dem in der PNRP-Cloud gesucht werden soll. Diese Zeichenfolge hat einen maximalen Grenzwert von 137 Unicode-Zeichen.

[in, optional] pwzCloudName

Der Name der Cloud, nach der nach der DRT gesucht werden soll, die dem MeshName entspricht.

Diese Zeichenfolge hat einen maximalen Grenzwert von 256 Unicode-Zeichen. Wenn leer gelassen wird, verwendet der PNRP-Bootstrapanbieter alle verfügbaren PNRP-Clouds.

[in, optional] pwzPublishingIdentity

Die PeerIdentity, die in der PNRP-Cloud veröffentlicht wird, die für das Bootstrapping verwendet wird. Diese Zeichenfolge hat eine maximale Beschränkung von 137 Unicode-Zeichen. Beachten Sie folgendes: Wenn fPublish auf TRUE festgelegt ist, muss PublishingIdentity den angegebenen PeerName veröffentlichen dürfen.

[out] ppResolver

Ein Zeiger auf den erstellten PNRP-Bootstrap-Resolver, der in der DRT_SETTINGS-Struktur verwendet wird.

Rückgabewert

Diese Funktion gibt S_OK nach Erfolg zurück. Weitere mögliche Werte sind:

Rückgabecode	Beschreibung
E_OUTOFMEMORY	Das System kann dem Anbieter keinen Arbeitsspeicher zuweisen.
E_INVALIDARG	pwzPeerName ist ungültig.
DRT_S_RETRY	Zugrunde liegende Aufrufe von PeerPnrpStartup oder PeerIdentityGetCryptKey geben einen vorübergehenden Fehler zurück. Versuchen Sie erneut, diese Funktion aufzurufen.

Hinweis Diese Funktion kann auch Fehler anzeigen, die von zugrunde liegenden Aufrufen von PeerPnrpStartup oder PeerIdentityGetCryptKey zurückgegeben werden.

Hinweise

Der standardmäßige PNRP-Bootstrap-Resolver, der von dieser Funktion erstellt wird, ist spezifisch für das DRT, für das er erstellt wird. Daher kann es nicht über mehrere DRTs hinweg wiederverwendet werden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	drt.h
Bibliothek	Drtprov.lib
DLL	Drt.dll

Weitere Informationen

DRT_SETTINGS

DrtDeletePnrpBootstrapResolver

Freigeben über