DRT_SETTINGS structure (drt.h)

  • Article

La structure DRT_SETTINGS contient les paramètres utilisés par la table de routage distribuée locale.

Syntaxe

typedef struct drt_settings_tag {
  DWORD                  dwSize;
  ULONG                  cbKey;
  BYTE                   bProtocolMajorVersion;
  BYTE                   bProtocolMinorVersion;
  ULONG                  ulMaxRoutingAddresses;
  PWSTR                  pwzDrtInstancePrefix;
  HDRT_TRANSPORT         hTransport;
  DRT_SECURITY_PROVIDER  *pSecurityProvider;
  DRT_BOOTSTRAP_PROVIDER *pBootstrapProvider;
  DRT_SECURITY_MODE      eSecurityMode;
} DRT_SETTINGS, *PDRT_SETTINGS;

Membres

dwSize

La taille de la structure spécifiée par le paramètre sizeof trouvé dans DRT_SETTINGS dans le but d’autoriser de nouveaux champs dans la structure dans les versions futures de l’API DRT.

cbKey

Spécifie le nombre exact d’octets pour les clés dans cette instance DRT. Actuellement, seuls 8 octets sont pris en charge. Toutes les autres valeurs retournent E_INVALIDARG via la fonction DrtOpen .

bProtocolMajorVersion

Pointeur vers le tableau d’octets qui représente la version principale du protocole spécifiée par l’application. Il est emballé dans chaque paquet DRT pour identifier la version des fournisseurs de sécurité ou de démarrage utilisés lorsqu’un seul instance DRT prend en charge plusieurs fournisseurs de sécurité ou de démarrage.

bProtocolMinorVersion

Pointeur vers le tableau d’octets qui représente la version mineure du protocole spécifiée par l’application. Il est emballé dans chaque paquet DRT pour identifier la version des fournisseurs de sécurité ou de démarrage utilisés lorsqu’un seul instance DRT prend en charge plusieurs fournisseurs de sécurité ou de démarrage.

ulMaxRoutingAddresses

Spécifie le nombre maximal d’adresses inscrites par la DRT lorsqu’une application inscrit une clé. La valeur maximale de ce champ est 4.

pwzDrtInstancePrefix

Cette chaîne constitue la base du nom de l’instance DRT. Le nom du instance peut être utilisé pour localiser les compteurs de performances Windows qui lui sont associés.

hTransport

Gérez vers un transport créé par l’API de création de transport. Il permet d’ouvrir une DRT avec un transport spécifié par la structure DRT_SETTINGS . Actuellement, seul IPv6 UDP est pris en charge via DrtCreateIpv6UdpTransport.

pSecurityProvider

Pointeur vers le fournisseur de sécurité spécifié pour l’utilisation. Une instance du fournisseur de sécurité de clé dérivée peut être obtenue en appelant DrtCreateDerivedKeySecurityProvider.

pBootstrapProvider

Pointeur vers le fournisseur d’amorçage spécifié pour l’utilisation. Une instance du fournisseur d’amorçage PNRP peut être obtenue en appelant DrtCreatePnrpBootstrapResolver.

eSecurityMode

Spécifie le mode de sécurité sous lequel la DRT doit fonctionner. Tous les nœuds participant à un maillage DRT doivent utiliser le même mode de sécurité.

Configuration requise

Condition requise Valeur
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]
En-tête drt.h

Voir aussi

DrtCreateIpv6UdpTransport

DrtCreatePnrpBootstrapResolver

DrtOpen