Funzione DrtCreatePnrpBootstrapResolver (drt.h)

Articolo
08/23/2023

La funzione DrtCreatePnrpBootstrapResolver crea un resolver bootstrap basato sul protocollo PNRP (Peer Name Resolution Protocol).

Sintassi

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

Parametri

[in] fPublish

Se TRUE, peerName contenuto in pwzPeerName e passato con il resolver bootstrap PNRP viene pubblicato dal DRT locale usando PNRP. Questo nodo sarà risolvibile da altri nodi usando il provider bootstrap PNRP e assisterà altri nodi che tentano di eseguire il bootstrap

[in] pwzPeerName

Nome del peer da cercare nel cloud PNRP. Questa stringa ha un limite massimo di 137 caratteri unicode

[in, optional] pwzCloudName

Nome del cloud da cercare in per DRT corrispondente al MeshName.

Questa stringa ha un limite massimo di 256 caratteri unicode. Se lasciato vuoto il provider di bootstrap PNRP userà tutti i cloud PNRP disponibili.

[in, optional] pwzPublishingIdentity

PeerIdentity che sta pubblicando nel cloud PNRP usato per il bootstrapping. Questa stringa ha un limite massimo di 137 caratteri unicode. È importante notare che se fPublish è impostato su TRUE, la pubblicazioneIdentity deve essere consentita per pubblicare il PeerName specificato.

[out] ppResolver

Puntatore al resolver bootstrap creato che viene usato nella struttura di DRT_SETTINGS .

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono:

Codice restituito	Descrizione
E_OUTOFMEMORY	Il sistema non può allocare memoria per il provider.
E_INVALIDARG	pwzPeerName non è valido.
DRT_S_RETRY	Le chiamate sottostanti a PeerPnrpStartup o PeerIdentityGetCryptKey restituiscono un errore temporaneo. Provare a chiamare di nuovo questa funzione.

Nota Questa funzione può anche visualizzare gli errori restituiti dalle chiamate sottostanti a PeerPnrpStartup o PeerIdentityGetCryptKey.

Commenti

Il Resolver bootstrap predefinito creato da questa funzione è specifico per il DRT per cui viene creato. Di conseguenza, non può essere usato nuovamente tra più set di ripristino di emergenza.

Requisiti


Client minimo supportato	Windows 7 Professional [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	drt.h
Libreria	Drtprov.lib
DLL	Drt.dll

Vedi anche

DRT_SETTINGS

DrtDeletePnrpBootstrapResolver