Compartir a través de

estructura DNS_TKEY_DATAW (windns.h)

  • Artículo

La estructura de DNS_TKEY_DATA representa un registro de recursos TKEY de DNS, que se usa para establecer y eliminar las claves secretas compartidas de un algoritmo entre una resolución DNS y un servidor, tal como se especifica en RFC 2930.

Sintaxis

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;

Miembros

pNameAlgorithm

Puntero a una cadena que representa el nombre de la clave tal como se define en la sección 2.1 de RFC 2930.

pAlgorithmPacket

Puntero a una cadena que representa el nombre del algoritmo tal como se define en la sección 2.3 de RFC 2930. pKey se usa para derivar las claves específicas del algoritmo.

pKey

Puntero a la clave secreta compartida de longitud variable.

pOtherData

Reservado. No utilizar.

dwCreateTime

Fecha y hora en que se creó la clave, expresada en segundos desde principios del 1 de enero de 1970, hora media de Greenwich (GMT), excluyendo los segundos bisiesto.

dwExpireTime

La fecha de expiración de la clave, expresada en segundos desde el inicio del 1 de enero de 1970, hora media de Greenwich (GMT), excluyendo los segundos bisiesto.

wMode

Esquema utilizado para el contrato de clave o el propósito del mensaje DNS TKEY. Los valores posibles para wMode se enumeran a continuación:

Value Significado
DNS_TKEY_MODE_SERVER_ASSIGN
 El servidor DNS asigna la clave y no se negocia.
DNS_TKEY_MODE_DIFFIE_HELLMAN
 El algoritmo de intercambio de claves Diffie-Hellman se usa para negociar la clave.
DNS_TKEY_MODE_GSS
La clave se intercambia a través de la negociación de interfaz de programa (GSS-API) de seguridad genérica Services-Application.
DNS_TKEY_MODE_RESOLVER_ASSIGN
 El solucionador DNS asigna la clave y no se negocia.

wError

Error, expresado en formato RCODE expandido que cubre el procesamiento de TSIG y TKEY RR.

Value Significado
DNS_RCODE_BADSIG
 La firma del DNS_TSIG_DATA RR es mala.
DNS_RCODE_BADKEY
 El campo pKey es incorrecto.
DNS_RCODE_BADTIME
 Una marca de tiempo es mala.

wKeyLength

Longitud, en bytes, del miembro pKey .

wOtherLength

Longitud, en bytes, del miembro pOtherData .

cAlgNameLength

Longitud, en bytes, del miembro pNameAlgorithm .

bPacketPointers

Reservado. No utilizar.

Comentarios

La estructura DNS_TKEY_DATA se usa junto con la estructura de DNS_RECORD para administrar mediante programación las entradas DNS.

Nota

El encabezado windns.h define DNS_TKEY_DATA como un alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado windns.h

Consulte también

DNS_RECORD

DNS_TSIG_DATA