estrutura DNS_TSIG_DATAW (windns.h)

Artigo
11/12/2024

A estrutura DNS_TSIG_DATA representa um RR (registro de recurso de autenticação de transação de chave secreta) (RR), conforme especificado em rfc 2845 e RFC 3645.

Sintaxe

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;

Membros

pNameAlgorithm

Um ponteiro para uma cadeia de caracteres que representa o nome da chave usada para gerar pSignature, conforme definido na seção 2.3 de RFC 2845.

pAlgorithmPacket

Um ponteiro para uma cadeia de caracteres que representa o nome do algoritmo usado para gerar pSignature, conforme definido na seção 2.3 de RFC 2845.

Valor	Significado
"gss.microsoft.com"	Somente Windows 2000 Server: Algoritmo de Serviço de Segurança Genérico para Autenticação de Transação de Chave Secreta para DNS (GSS-API) conforme definido em RFC 3645.
"gss-tsig"	Algoritmo de serviço de segurança genérico para autenticação de transação de chave secreta para DNS (GSS-API) conforme definido em RFC 3645.

pSignature

Um ponteiro para o MAC (Código de Autenticação de Mensagem) gerado pelo algoritmo em pAlgorithmPacket. O comprimento, em bytes, e a composição de pSignature são determinados por pAlgorithmPacket.

pOtherData

Se wError contiver o RCODE, BADTIME, pOtherData é uma matriz BYTE que contém a hora atual do servidor, caso contrário, é NULL. O tempo é expresso em segundos desde o início de 1º de janeiro de 1970, Gmt (Horário médio de Greenwich), excluindo segundos bissextos.

i64CreateTime

O tempo pSignature foi gerado, expresso em segundos desde o início de 1º de janeiro de 1970, Gmt (Horário Médio de Greenwich), excluindo segundos bissextos.

wFudgeTime

O tempo, em segundos, i64CreateTime pode estar em erro.

wOriginalXid

O identificador Xid da mensagem original.

wError

Um erro, expresso no formato RCODE expandido que abrange o processamento de TSIG e TKEY RR.

Valor	Significado
DNS_RCODE_BADSIG	O campo pSignature é ruim.
DNS_RCODE_BADKEY	O campo pKey da RR do DNS_TKEY_DATA é ruim.
DNS_RCODE_BADTIME	Um carimbo de data/hora é ruim.

wSigLength

O comprimento, em bytes, do membro pSignature.

wOtherLength

O comprimento, em bytes, do membro pOtherData.

cAlgNameLength

O comprimento, em bytes, do membro pAlgorithmPacket .

bPacketPointers

Reservado para uso futuro. Não use.

Observações

A estrutura de DNS_TSIG_DATA é usada em conjunto com a estrutura DNS_RECORD para gerenciar programaticamente as entradas DNS.

Nota

O cabeçalho windns.h define DNS_TSIG_DATA como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho	windns.h

Consulte também

DNS_RECORD

DNS_TKEY_DATA

Compartilhar via