estructura DNS_TKEY_DATAW (windns.h)

La estructura 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 de secreto compartido de longitud variable.

pOtherData

Reservado. No use.

dwCreateTime

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

dwExpireTime

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

wMode

Un esquema usado para el acuerdo de clave o el propósito del mensaje DNS TKEY. A continuación se enumeran los valores posibles para wMode:

Valor	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 de seguridad genérica Services-Application (GSS-API).
DNS_TKEY_MODE_RESOLVER_ASSIGN	La clave se asigna mediante la resolución DNS y no se negocia.

wError

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

Valor	Significado
DNS_RCODE_BADSIG	El de la DNS_TSIG_DATA RR es malo.
DNS_RCODE_BADKEY	El campo pKey no es válido.
DNS_RCODE_BADTIME	Una marca de tiempo es mala.

wKeyLength

Longitud, en bytes, del miembro pKey de .

wOtherLength

Longitud, en bytes, del miembro pOtherData.

cAlgNameLength

Longitud, en bytes, del miembro pNameAlgorithm.

bPacketPointers

Reservado. No use.

Observaciones

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

Nota

El encabezado windns.h define DNS_TKEY_DATA como 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
encabezado de	windns.h

Consulte también

DNS_RECORD

DNS_TSIG_DATA