structure DNS_TSIG_DATAA (windns.h)

Article
08/27/2023

La structure DNS_TSIG_DATA représente un enregistrement de ressource d’authentification transactionnelle par clé secrète (TSIG) comme spécifié dans RFC 2845 et RFC 3645.

Syntaxe

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;

Membres

pNameAlgorithm

Pointeur vers une chaîne qui représente le nom de la clé utilisée pour générer pSignature , comme défini dans la section 2.3 de la RFC 2845.

pAlgorithmPacket

Pointeur vers une chaîne qui représente le nom de l’algorithme utilisé pour générer pSignature , comme défini dans la section 2.3 de la RFC 2845.

Valeur	Signification
« gss.microsoft.com »	Windows 2000 Server uniquement : algorithme de service de sécurité générique pour l’authentification transactionnelle par clé secrète pour DNS (GSS-API) tel que défini dans RFC 3645.
« gss-tsig »	Algorithme de service de sécurité générique pour l’authentification transactionnelle par clé secrète pour DNS (GSS-API) tel que défini dans RFC 3645.

pSignature

Pointeur vers le code d’authentification de message (MAC) généré par l’algorithme dans pAlgorithmPacket. La longueur, en octets, et la composition de pSignature sont déterminées par pAlgorithmPacket.

pOtherData

Si wError contient le RCODE, BADTIME, pOtherData est un tableau BYTE qui contient l’heure actuelle du serveur, sinon il est NULL. Le temps est exprimé en secondes depuis le début du 1er janvier 1970, heure moyenne de Greenwich (GMT), à l’exclusion des secondes bissextiles.

i64CreateTime

Le temps pSignature a été généré, exprimé en secondes depuis le début du 1er janvier 1970, heure moyenne de Greenwich (GMT), à l’exclusion des secondes bissextiles.

wFudgeTime

Le temps, en secondes, i64CreateTime peut être en erreur.

wOriginalXid

Identificateur Xid du message d’origine.

wError

Erreur, exprimée au format RCODE développé qui couvre le traitement TSIG et TKEY RR.

Valeur	Signification
DNS_RCODE_BADSIG	Le champ pSignature est incorrect.
DNS_RCODE_BADKEY	Le champ pKey du DNS_TKEY_DATA RR est incorrect.
DNS_RCODE_BADTIME	Un horodatage est mauvais.

wSigLength

Longueur, en octets, du membre pSignature .

wOtherLength

Longueur, en octets, du membre pOtherData .

cAlgNameLength

Longueur, en octets, du membre pAlgorithmPacket .

bPacketPointers

Réservé pour un usage futur. Ne pas utiliser.

Remarques

La structure DNS_TSIG_DATA est utilisée conjointement avec la structure DNS_RECORD pour gérer par programmation les entrées DNS.

Notes

L’en-tête windns.h définit DNS_TSIG_DATA en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	windns.h

Voir aussi

DNS_RECORD

DNS_TKEY_DATA

Partager via