DNS_TSIG_DATAA Struktur (windns.h)

Artikel
11/12/2024

Die DNS_TSIG_DATA-Struktur stellt einen TSIG-Ressourceneintrag (Secret Key Transaction Authentication) dar, wie in RFC 2845- und RFC 3645-angegeben.

Syntax

typedef struct {
  PSTR     pNameAlgorithm;
  PBYTE    pAlgorithmPacket;
  PBYTE    pSignature;
  PBYTE    pOtherData;
  LONGLONG i64CreateTime;
  WORD     wFudgeTime;
  WORD     wOriginalXid;
  WORD     wError;
  WORD     wSigLength;
  WORD     wOtherLength;
  UCHAR    cAlgNameLength;
  BOOL     bPacketPointers;
} DNS_TSIG_DATAA, *PDNS_TSIG_DATAA;

Angehörige

pNameAlgorithm

Ein Zeiger auf eine Zeichenfolge, die den Namen des Schlüssels darstellt, der zum Generieren pSignature- gemäß Abschnitt 2.3 von RFC 2845-verwendet wird.

pAlgorithmPacket

Ein Zeiger auf eine Zeichenfolge, die den Namen des Algorithmus darstellt, der zum Generieren pSignature- gemäß Abschnitt 2.3 von RFC 2845-verwendet wird.

Wert	Bedeutung
"gss.microsoft.com"	Windows 2000 Server only: Generic Security Service Algorithm for Secret Key Transaction Authentication for DNS (GSS-API) as defined in RFC 3645.
"gss-tsig"	Generic Security Service Algorithm for Secret Key Transaction Authentication for DNS (GSS-API) as defined in RFC 3645.

pSignature

Ein Zeiger auf den Vom Algorithmus generierten Nachrichtenauthentifizierungscode (MAC) in pAlgorithmPacket. Die Länge in Byte und die Zusammensetzung von pSignature- werden durch pAlgorithmPacketbestimmt.

pOtherData

Wenn wError- den RCODE enthält, BADTIME, pOtherData ist ein BYTE-Array, das die aktuelle Uhrzeit des Servers enthält, andernfalls ist es NULL-. Die Zeit wird in Sekunden seit Beginn des 1. Januar 1970 ausgedrückt, Greenwich Mean Time (GMT), mit Ausnahme von Schaltsekunden.

i64CreateTime

Die Zeit pSignature generiert wurde, ausgedrückt in Sekunden seit Dem 1. Januar 1970, Greenwich Mean Time (GMT), mit Ausnahme von Schaltsekunden.

wFudgeTime

Die Zeit in Sekunden i64CreateTime- ist möglicherweise fehlerhaft.

wOriginalXid

Der Xid Bezeichner der ursprünglichen Nachricht.

wError

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

Wert	Bedeutung
DNS_RCODE_BADSIG	Das Feld "pSignature" ist ungültig.
DNS_RCODE_BADKEY	Das pKey- Feld des DNS_TKEY_DATA RR ist schlecht.
DNS_RCODE_BADTIME	Ein Zeitstempel ist schlecht.

wSigLength

Die Länge des pSignature Members in Byte.

wOtherLength

Die Länge des pOtherData- Elements in Bytes.

cAlgNameLength

Die Länge des pAlgorithmPacket- Elements in Byte.

bPacketPointers

Reserviert für die zukünftige Verwendung. Nicht verwenden.

Bemerkungen

Die DNS_TSIG_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_TSIG_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_TKEY_DATA

Freigeben über