Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

DRT_SETTINGS structure

The DRT_SETTINGS structure contains the settings utilized by the local Distributed Routing Table.

Syntax


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

Members

dwSize

The size of the structure specified by the sizeof parameter found in DRT_SETTINGS with the purpose of allowing new fields in the structure in future versions of the DRT API.

cbKey

Specifies the exact number of bytes for keys in this DRT instance. Currently only 8 bytes are supported. Any other values will return E_INVALIDARG via the DrtOpen function.

bProtocolMajorVersion

Pointer to the byte array that represents the protocol major version specified by the application. This is packed in every DRT packet to identify the version of the Security or Bootstrap Providers in use when a single DRT instance is supporting multiple Security or Bootstrap Providers.

bProtocolMinorVersion

Pointer to the byte array that represents the protocol minor version specified by the application. This is packed in every DRT packet to identify the version of the Security or Bootstrap Providers in use when a single DRT instance is supporting multiple Security or Bootstrap Providers.

ulMaxRoutingAddresses

Specifies the maximum number of address the DRT registers when an application registers a key. The maximum value for this field is 4.

pwzDrtInstancePrefix

This string forms the basis of the name of the DRT instance. The name of the instance can be used to locate the Windows performance counters associated with it.

hTransport

Handle to a transport created by the transport creation API. This is used to open a DRT with a transport specified by the DRT_SETTINGS structure. Currently only IPv6 UDP is supported via DrtCreateIpv6UdpTransport.

pSecurityProvider

Pointer to the security provider specified for use. An instance of the Derived Key Security Provider can be obtained by calling DrtCreateDerivedKeySecurityProvider.

pBootStrapProvider

Pointer to the Bootstrap Provider specified for use. An instance of the PNRP Bootstrap Provider can be obtained by calling DrtCreatePnrpBootstrapResolver.

eSecurityMode

Specifies the security mode that the DRT should operate under. All nodes participating in a DRT mesh must use the same security mode.

Requirements

Minimum supported client

Windows 7 Professional [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Drt.h

See also

DrtOpen
DrtCreateIpv6UdpTransport
DrtCreatePnrpBootstrapResolver

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.