DRT_SETTINGS structure (drt.h)

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

Syntax

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;

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

See also

DrtCreateIpv6UdpTransport

DrtCreatePnrpBootstrapResolver

DrtOpen