DNS_TKEY_DATAW Struktur (windns.h)

Artikel
08/27/2023

Die DNS_TKEY_DATA-Struktur stellt einen DNS-TKEY-Ressourcendatensatz dar, der zum Einrichten und Löschen der freigegebenen geheimen Schlüssel eines Algorithmus zwischen einem DNS-Resolver und einem Server verwendet wird, wie in RFC 2930 angegeben.

Syntax

typedef struct {
  PWSTR pNameAlgorithm;
  PBYTE pAlgorithmPacket;
  PBYTE pKey;
  PBYTE pOtherData;
  DWORD dwCreateTime;
  DWORD dwExpireTime;
  WORD  wMode;
  WORD  wError;
  WORD  wKeyLength;
  WORD  wOtherLength;
  UCHAR cAlgNameLength;
  BOOL  bPacketPointers;
} DNS_TKEY_DATAW, *PDNS_TKEY_DATAW;

Member

pNameAlgorithm

Ein Zeiger auf eine Zeichenfolge, die den Namen des Schlüssels darstellt, wie in Abschnitt 2.1 von RFC 2930 definiert.

pAlgorithmPacket

Ein Zeiger auf eine Zeichenfolge, die den Namen des Algorithmus gemäß Abschnitt 2.3 von RFC 2930 darstellt. pKey wird verwendet, um die algorithmusspezifischen Schlüssel abzuleiten.

pKey

Ein Zeiger auf den shared-secret-Schlüssel mit variabler Länge.

pOtherData

Reserviert. Darf nicht verwendet werden.

dwCreateTime

Das Datum und die Uhrzeit der Schlüsselerstellung, ausgedrückt in Sekunden seit Anfang des 1. Januar 1970, Greenwich Mean Time (GMT), ohne Schaltsekunden.

dwExpireTime

Das Ablaufdatum des Schlüssels, ausgedrückt in Sekunden seit Anfang des 1. Januar 1970, Greenwich Mean Time (GMT), ohne Schaltsekunden.

wMode

Ein Schema, das für die Schlüsselvereinbarung oder den Zweck der TKEY-DNS-Nachricht verwendet wird. Mögliche Werte für wMode sind unten aufgeführt:

Wert	Bedeutung
DNS_TKEY_MODE_SERVER_ASSIGN	Der Schlüssel wird vom DNS-Server zugewiesen und nicht ausgehandelt.
DNS_TKEY_MODE_DIFFIE_HELLMAN	Der Diffie-Hellman Schlüsselaustauschalgorithmus wird verwendet, um den Schlüssel auszuhandeln.
DNS_TKEY_MODE_GSS	Der Schlüssel wird über die GSS-API-Aushandlung (Generic Security Services-Application Program Interface) ausgetauscht.
DNS_TKEY_MODE_RESOLVER_ASSIGN	Der Schlüssel wird vom DNS-Resolver zugewiesen und nicht ausgehandelt.

wError

Ein Fehler, der im erweiterten RCODE-Format ausgedrückt wird und die TSIG- und TKEY RR-Verarbeitung abdeckt.

Wert	Bedeutung
DNS_RCODE_BADSIG	Die pSignature der DNS_TSIG_DATA RR ist schlecht.
DNS_RCODE_BADKEY	Das pKey-Feld ist ungültig.
DNS_RCODE_BADTIME	Ein Zeitstempel ist schlecht.

wKeyLength

Länge des pKey-Elements in Bytes.

wOtherLength

Die Länge des pOtherData-Elements in Bytes.

cAlgNameLength

Die Länge des pNameAlgorithm-Elements in Bytes.

bPacketPointers

Reserviert. Darf nicht verwendet werden.

Hinweise

Die DNS_TKEY_DATA-Struktur wird in Verbindung mit der DNS_RECORD-Struktur verwendet, um DNS-Einträge programmgesteuert zu verwalten.

Hinweis

Der windns.h-Header definiert DNS_TKEY_DATA als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	windns.h

Weitere Informationen

DNS_RECORD

DNS_TSIG_DATA

Freigeben über