DRT_SETTINGS-Struktur (drt.h)

Die DRT_SETTINGS-Struktur enthält die Einstellungen, die von der lokalen Verteilten Routingtabelle verwendet werden.

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;

Member

dwSize

Die Größe der Struktur, die durch den Parameter sizeof in DRT_SETTINGS angegeben wird, um in zukünftigen Versionen der DRT-API neue Felder in der Struktur zuzulassen.

cbKey

Gibt die genaue Anzahl von Bytes für Schlüssel in dieser DRT-instance an. Derzeit werden nur 8 Bytes unterstützt. Alle anderen Werte geben über die DrtOpen-Funktion E_INVALIDARG zurück.

bProtocolMajorVersion

Zeiger auf das Bytearray, das die von der Anwendung angegebene Hauptversion des Protokolls darstellt. Dies wird in jedes DRT-Paket gepackt, um die Version der verwendeten Sicherheits- oder Bootstrapanbieter zu identifizieren, wenn ein einzelner DRT-instance mehrere Sicherheits- oder Bootstrapanbieter unterstützt.

bProtocolMinorVersion

Zeiger auf das Bytearray, das die von der Anwendung angegebene Nebenversion des Protokolls darstellt. Dies wird in jedes DRT-Paket gepackt, um die Version der verwendeten Sicherheits- oder Bootstrapanbieter zu identifizieren, wenn ein einzelner DRT-instance mehrere Sicherheits- oder Bootstrapanbieter unterstützt.

ulMaxRoutingAddresses

Gibt die maximale Anzahl von Adressen an, die vom DRT registriert werden, wenn eine Anwendung einen Schlüssel registriert. Der maximale Wert für dieses Feld ist 4.

pwzDrtInstancePrefix

Diese Zeichenfolge bildet die Grundlage für den Namen des DRT-instance. Der Name des instance kann verwendet werden, um die zugeordneten Windows-Leistungsindikatoren zu suchen.

hTransport

Behandeln eines Transports, der von der Transporterstellungs-API erstellt wurde. Dies wird verwendet, um eine DRT mit einem Transport zu öffnen, der von der DRT_SETTINGS-Struktur angegeben wird. Derzeit wird nur IPv6 UDP über DrtCreateIpv6UdpTransport unterstützt.

pSecurityProvider

Zeiger auf den sicherheitsrelevanten Anbieter, der zur Verwendung angegeben ist. Eine instance des Abgeleiteten Schlüsselsicherheitsanbieters kann abgerufen werden, indem Sie DrtCreateDerivedKeySecurityProvider aufrufen.

pBootstrapProvider

Zeiger auf den bootstrap-Anbieter, der zur Verwendung angegeben ist. Eine instance des PNRP-Bootstrap-Anbieters kann abgerufen werden, indem Sie DrtCreatePnrpBootstrapResolver aufrufen.

eSecurityMode

Gibt den Sicherheitsmodus an, unter dem die DRT ausgeführt werden soll. Alle Knoten, die an einem DRT-Gitternetz teilnehmen, müssen denselben Sicherheitsmodus verwenden.

Anforderungen

Weitere Informationen

DrtCreateIpv6UdpTransport

DrtCreatePnrpBootstrapResolver

DrtOpen