structure DNS_TKEY_DATAW (windns.h)

Article
11/12/2024

La structure DNS_TKEY_DATA représente un enregistrement de ressource TKEY DNS, utilisé pour établir et supprimer les clés secrètes partagées d’un algorithme entre un programme de résolution DNS et un serveur, comme spécifié dans RFC 2930.

Syntaxe

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;

Membres

pNameAlgorithm

Pointeur vers une chaîne qui représente le nom de la clé tel que défini dans la section 2.1 de RFC 2930.

pAlgorithmPacket

Pointeur vers une chaîne représentant le nom de l’algorithme tel que défini dans la section 2.3 de RFC 2930. clé pKey est utilisée pour dériver les clés spécifiques de l’algorithme.

pKey

Pointeur vers la clé secrète partagée de longueur variable.

pOtherData

Réservé. N’utilisez pas.

dwCreateTime

Date et heure à laquelle la clé a été créée, exprimée en secondes depuis le début du 1er janvier 1970, Heure moyenne de Greenwich (GMT), à l’exception des secondes bissextiles.

dwExpireTime

Date d’expiration de la clé, exprimée en secondes depuis le début du 1er janvier 1970, Heure moyenne de Greenwich (GMT), à l’exception des secondes bissextiles.

wMode

Schéma utilisé pour le contrat de clé ou l’objectif du message DNS TKEY. Les valeurs possibles pour wMode sont répertoriées ci-dessous :

Valeur	Signification
DNS_TKEY_MODE_SERVER_ASSIGN	La clé est affectée par le serveur DNS et n’est pas négociée.
DNS_TKEY_MODE_DIFFIE_HELLMAN	L’algorithme d’échange de clés Diffie-Hellman est utilisé pour négocier la clé.
DNS_TKEY_MODE_GSS	La clé est échangée par le biais de la négociation de l’interface du programme Services-Application de sécurité générique (GSS-API).
DNS_TKEY_MODE_RESOLVER_ASSIGN	La clé est affectée par le programme de résolution DNS et n’est pas négociée.

wError

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

Valeur	Signification
DNS_RCODE_BADSIG	Le pSignature de la DNS_TSIG_DATA RR est incorrect.
DNS_RCODE_BADKEY	Le champ pKey est incorrect.
DNS_RCODE_BADTIME	Un horodatage est mauvais.

wKeyLength

Longueur, en octets, du membre pKey .

wOtherLength

Longueur, en octets, du membre pOtherData .

cAlgNameLength

Longueur, en octets, du membre pNameAlgorithm.

bPacketPointers

Réservé. N’utilisez pas.

Remarques

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

Note

L’en-tête windns.h définit DNS_TKEY_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_TSIG_DATA

Partager via