DRT_SETTINGS structure (drt.h)
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 |