DNS_TKEY_DATAA Struktur (windns.h)

Artikel
11/12/2024

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

Syntax

typedef struct {
  PSTR  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_DATAA, *PDNS_TKEY_DATAA;

Angehörige

pNameAlgorithm

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

pAlgorithmPacket

Ein Zeiger auf eine Zeichenfolge, die den Namen des Algorithmus darstellt, wie in Abschnitt 2.3 von RFC 2930definiert. pKey- wird verwendet, um die algorithmusspezifischen Schlüssel abzuleiten.

pKey

Ein Zeiger auf den gemeinsam genutzten Schlüssel mit variabler Länge.

pOtherData

Reserviert. Nicht verwenden.

dwCreateTime

Das Datum und die Uhrzeit, zu dem der Schlüssel erstellt wurde, ausgedrückt in Sekunden seit Dem 1. Januar 1970, Greenwich Mean Time (GMT), mit Ausnahme von Schaltsekunden.

dwExpireTime

Das Ablaufdatum des Schlüssels, ausgedrückt in Sekunden seit Beginn 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 wird 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 generic Security Services-Application Program Interface (GSS-API) Aushandlung ausgetauscht.
DNS_TKEY_MODE_RESOLVER_ASSIGN	Der Schlüssel wird vom DNS-Resolver zugewiesen und wird nicht ausgehandelt.

wError

Ein Fehler, ausgedrückt im erweiterten RCODE-Format, das DIE TSIG- und TKEY RR-Verarbeitung abdeckt.

Wert	Bedeutung
DNS_RCODE_BADSIG	Die pSignature- des 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 Members in Byte.

bPacketPointers

Reserviert. Nicht verwenden.

Bemerkungen

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

Anmerkung

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 Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Header-	windns.h

Siehe auch

DNS_RECORD

DNS_TSIG_DATA

Freigeben über