structure DNS_TKEY_DATAA (windns.h)

Article
08/27/2023

La structure DNS_TKEY_DATA représente un enregistrement de ressource DNS TKEY, 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 {
  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;

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 la 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 la RFC 2930. pKey est utilisé pour dériver les clés spécifiques à l’algorithme.

pKey

Pointeur vers la clé de secret partagé de longueur variable.

pOtherData

Réservé. Ne pas utiliser.

dwCreateTime

Date et heure de création de la clé, exprimées en secondes depuis le début du 1er janvier 1970, heure moyenne de Greenwich (GMT), à l’exclusion 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’exclusion des secondes bissextiles.

wMode

Schéma utilisé pour l’accord 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 via la négociation de l’interface de programme de sécurité générique Services-Application (API GSS).
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 du 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é. Ne pas utiliser.

Remarques

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

Notes

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

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_TSIG_DATA

Partager via