struttura DNS_TSIG_DATAW (windns.h)

Articolo
11/12/2024

La struttura DNS_TSIG_DATA rappresenta un record di risorse TSIG (Secret Key Transaction Authentication) come specificato in RFC 2845 e RFC 3645.

Sintassi

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;

Membri

pNameAlgorithm

Puntatore a una stringa che rappresenta il nome della chiave usata per generare pSignature come definito nella sezione 2.3 di RFC 2845.

pAlgorithmPacket

Puntatore a una stringa che rappresenta il nome dell'algoritmo usato per generare pSignature come definito nella sezione 2.3 di RFC 2845.

Valore	Significato
"gss.microsoft.com"	Solo Windows 2000 Server: algoritmo generico del servizio di sicurezza per l'autenticazione delle transazioni con chiave privata per DNS (GSS-API) come definito in RFC 3645.
"gss-tsig"	Algoritmo del servizio di sicurezza generico per l'autenticazione delle transazioni con chiave privata per DNS (GSS-API) come definito in RFC 3645.

pSignature

Puntatore al codice MAC (Message Authentication Code) generato dall'algoritmo in pAlgorithmPacket. La lunghezza, in byte e la composizione di pSignature sono determinate da pAlgorithmPacket.

pOtherData

Se wError contiene RCODE, BADTIME, pOtherData è una matrice BYTE contenente l'ora corrente del server; in caso contrario, è NULL. Il tempo è espresso in secondi dall'inizio del 1° gennaio 1970, greenwich mean time (GMT), escluso i secondi intercalari.

i64CreateTime

L'ora pSignature è stata generata, espressa in secondi dall'inizio del 1° gennaio 1970, ora di Greenwich Mean Time (GMT), escluso i secondi intercalari.

wFudgeTime

Il tempo, in secondi, i64CreateTime potrebbe essere in errore.

wOriginalXid

Identificatore xid del messaggio originale.

wError

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

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

wSigLength

Lunghezza, in byte, del membro pSignature.

wOtherLength

Lunghezza, in byte, del membro pOtherData.

cAlgNameLength

Lunghezza, in byte, del membro pAlgorithmPacket.

bPacketPointers

Riservato per uso futuro. Non usare.

Osservazioni

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

Nota

L'intestazione windns.h definisce DNS_TSIG_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_TKEY_DATA

Condividi tramite