Fonction DrtCreatePnrpBootstrapResolver (drt.h)

Article
08/23/2023

La fonction DrtCreatePnrpBootstrapResolver crée un programme de résolution d’amorçage basé sur le protocole PNRP (Peer Name Resolution Protocol).

Syntaxe

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

Paramètres

[in] fPublish

Si la valeur est TRUE, le PeerName contenu dans pwzPeerName et passé avec le programme de résolution d’amorçage PNRP est publié par la DRT locale à l’aide de PNRP. Ce nœud sera résolu par d’autres nœuds à l’aide du fournisseur d’amorçage PNRP et aidera d’autres nœuds qui tentent de démarrer

[in] pwzPeerName

Nom de l’homologue à rechercher dans le cloud PNRP. Cette chaîne a une limite maximale de 137 caractères Unicode

[in, optional] pwzCloudName

Nom du cloud à rechercher dans pour la DRT correspondant à MeshName.

Cette chaîne a une limite maximale de 256 caractères Unicode. S’il n’est pas renseigné, le fournisseur d’amorçage PNRP utilise tous les clouds PNRP disponibles.

[in, optional] pwzPublishingIdentity

PeerIdentity qui publie dans le cloud PNRP utilisé pour le démarrage. Cette chaîne a une limite maximale de 137 caractères Unicode. Il est important de noter que si fPublish a la valeur TRUE, PublishingIdentity doit être autorisé à publier le PeerName spécifié.

[out] ppResolver

Pointeur vers le programme de résolution d’amorçage PNRP créé qui est utilisé dans la structure DRT_SETTINGS .

Valeur retournée

Cette fonction retourne S_OK en cas de réussite. Les autres valeurs possibles sont les suivantes :

Code de retour	Description
E_OUTOFMEMORY	Le système ne peut pas allouer de mémoire pour le fournisseur.
E_INVALIDARG	pwzPeerName n’est pas valide.
DRT_S_RETRY	Les appels sous-jacents à PeerPnrpStartup ou PeerIdentityGetCryptKey retournent une erreur temporaire. Réessayez d’appeler cette fonction.

Note Cette fonction peut également faire apparaître des erreurs retournées par les appels sous-jacents à PeerPnrpStartup ou PeerIdentityGetCryptKey.

Notes

Le programme de résolution d’amorçage PNRP par défaut créé par cette fonction est spécifique à la DRT pour laquelle elle est créée. Par conséquent, il ne peut pas être réutilisé sur plusieurs DRT.

Spécifications


Client minimal pris en charge	Windows 7 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	drt.h
Bibliothèque	Drtprov.lib
DLL	Drt.dll

Voir aussi

DRT_SETTINGS

DrtDeletePnrpBootstrapResolver