estrutura DNS_TKEY_DATAW (windns.h)

Artigo
11/12/2024

A estrutura DNS_TKEY_DATA representa um registro de recurso TKEY DNS, usado para estabelecer e excluir as chaves de segredo compartilhado de um algoritmo entre um resolvedor DNS e um servidor, conforme especificado em RFC 2930.

Sintaxe

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;

Membros

pNameAlgorithm

Um ponteiro para uma cadeia de caracteres que representa o nome da chave conforme definido na seção 2.1 de RFC 2930.

pAlgorithmPacket

Um ponteiro para uma cadeia de caracteres que representa o nome do algoritmo, conforme definido na seção 2.3 de RFC 2930. pKey é usado para derivar as chaves específicas do algoritmo.

pKey

Um ponteiro para a chave de segredo compartilhado de comprimento variável.

pOtherData

Reservado. Não use.

dwCreateTime

A data e a hora em que a chave foi criada, expressa em segundos desde o início de 1º de janeiro de 1970, Gmt (Horário Médio de Greenwich), excluindo segundos bissextos.

dwExpireTime

A data de validade da chave, expressa em segundos desde o início de 1º de janeiro de 1970, Gmt (Horário Médio de Greenwich), excluindo segundos bissextos.

wMode

Um esquema usado para o contrato de chave ou a finalidade da mensagem DNS TKEY. Os valores possíveis para wMode estão listados abaixo:

Valor	Significado
DNS_TKEY_MODE_SERVER_ASSIGN	A chave é atribuída pelo servidor DNS e não é negociada.
DNS_TKEY_MODE_DIFFIE_HELLMAN	O algoritmo de troca de chaves Diffie-Hellman é usado para negociar a chave.
DNS_TKEY_MODE_GSS	A chave é trocada por meio da negociação de Interface do Programa de Services-Application de Segurança Genérica (GSS-API).
DNS_TKEY_MODE_RESOLVER_ASSIGN	A chave é atribuída pelo resolvedor DNS e não é negociada.

wError

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

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

wKeyLength

Comprimento, em bytes, do membro pKey .

wOtherLength

O comprimento, em bytes, do membro pOtherData.

cAlgNameLength

O comprimento, em bytes, do membro pNameAlgorithm .

bPacketPointers

Reservado. Não use.

Observações

A estrutura DNS_TKEY_DATA é usada em conjunto com a estrutura DNS_RECORD para gerenciar programaticamente entradas DNS.

Nota

O cabeçalho windns.h define DNS_TKEY_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_TSIG_DATA

Compartilhar via