structure DNS_TSIG_DATAW (windns.h)

Article
11/12/2024

La structure DNS_TSIG_DATA représente un enregistrement de ressource TSIG (Secret Key Transaction Authentication) tel que spécifié dans RFC 2845 et RFC 3645.

Syntaxe

typedef struct {
  PWSTR    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_DATAW, *PDNS_TSIG_DATAW;

Membres

pNameAlgorithm

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

pAlgorithmPacket

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

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

pSignature

Pointeur vers le code d’authentification des messages (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 code 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’exception des secondes bissextiles.

i64CreateTime

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

wFudgeTime

La durée, 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 une utilisation ultérieure. N’utilisez pas.

Remarques

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

Note

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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	windns.h

Voir aussi

DNS_RECORD

DNS_TKEY_DATA

Partager via