struttura DNS_TKEY_DATAA (windns.h)

Articolo
11/12/2024

La struttura DNS_TKEY_DATA rappresenta un record di risorse TKEY DNS, usato per stabilire ed eliminare le chiavi segrete condivise di un algoritmo tra un resolver DNS e un server come specificato in RFC 2930.

Sintassi

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;

Membri

pNameAlgorithm

Puntatore a una stringa che rappresenta il nome della chiave come definito nella sezione 2.1 di RFC 2930.

pAlgorithmPacket

Puntatore a una stringa che rappresenta il nome dell'algoritmo come definito nella sezione 2.3 di RFC 2930. pKey viene usato per derivare le chiavi specifiche dell'algoritmo.

pKey

Puntatore alla chiave privata condivisa a lunghezza variabile.

pOtherData

Riservato. Non usare.

dwCreateTime

Data e ora in cui è stata creata la chiave, espressa in secondi dall'inizio del 1° gennaio 1970, ora di Greenwich Mean Time (GMT), esclusi i secondi intercalari.

dwExpireTime

Data di scadenza della chiave, espressa in secondi dall'inizio del 1° gennaio 1970, Ora di Greenwich (GMT), escluso i secondi intercalari.

wMode

Schema usato per il contratto chiave o lo scopo del messaggio DNS TKEY. Di seguito sono elencati i valori possibili per wMode:

Valore	Significato
DNS_TKEY_MODE_SERVER_ASSIGN	La chiave viene assegnata dal server DNS e non viene negoziata.
DNS_TKEY_MODE_DIFFIE_HELLMAN	L'algoritmo di scambio di chiavi Diffie-Hellman viene usato per negoziare la chiave.
DNS_TKEY_MODE_GSS	La chiave viene scambiata tramite negoziazione Generic Security Services-Application Program Interface (GSS-API).
DNS_TKEY_MODE_RESOLVER_ASSIGN	La chiave viene assegnata dal sistema di risoluzione DNS e non viene negoziata.

wError

Errore, espresso in formato RCODE espanso che copre l'elaborazione TSIG e TKEY RR.

Valore	Significato
DNS_RCODE_BADSIG	Il pSignature del DNS_TSIG_DATA RR non è valido.
DNS_RCODE_BADKEY	Il campo pKey non è valido.
DNS_RCODE_BADTIME	Un timestamp non è valido.

wKeyLength

Lunghezza, in byte, del membro pKey .

wOtherLength

Lunghezza, in byte, del membro pOtherData.

cAlgNameLength

Lunghezza, in byte, del membro pNameAlgorithm .

bPacketPointers

Riservato. Non usare.

Osservazioni

La struttura DNS_TKEY_DATA viene usata insieme alla struttura DNS_RECORD per gestire le voci DNS a livello di codice.

Nota

L'intestazione windns.h definisce DNS_TKEY_DATA come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	windns.h

Vedere anche

DNS_RECORD

DNS_TSIG_DATA

Condividi tramite