Compartir a través de

estructura DNS_TSIG_DATAA (windns.h)

  • Artículo

La estructura DNS_TSIG_DATA representa un registro de recursos de autenticación de transacciones de clave secreta (TSIG) tal como se especifica en RFC 2845 y RFC 3645.

Sintaxis

typedef struct {
  PSTR     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_DATAA, *PDNS_TSIG_DATAA;

Miembros

pNameAlgorithm

Puntero a una cadena que representa el nombre de la clave utilizada para generar pSignature tal como se define en la sección 2.3 de RFC 2845.

pAlgorithmPacket

Puntero a una cadena que representa el nombre del algoritmo utilizado para generar pSignature tal como se define en la sección 2.3 de RFC 2845.

Valor Significado
"gss.microsoft.com"
 Solo servidor de Windows 2000: algoritmo de servicio de seguridad genérico para la autenticación de transacciones de clave secreta para DNS (GSS-API) tal como se define en RFC 3645.
"gss-tsig"
 Algoritmo de servicio de seguridad genérico para la autenticación de transacciones de clave secreta para DNS (GSS-API) tal como se define en RFC 3645.

pSignature

Puntero al código de autenticación de mensajes (MAC) generado por el algoritmo en pAlgorithmPacket. La longitud, en bytes y composición de de firma se determina mediante pAlgorithmPacket.

pOtherData

Si wError contiene RCODE, BADTIME, pOtherData es una matriz BYTE que contiene la hora actual del servidor; de lo contrario, es NULL. El tiempo se expresa en segundos desde el 1 de enero de 1970, hora media de Greenwich (GMT), excluyendo los segundos bisiesto.

i64CreateTime

La hora de pSignature se generó, expresada en segundos desde principios del 1 de enero de 1970, hora media de Greenwich (GMT), excluyendo los segundos bisiesto.

wFudgeTime

El tiempo, en segundos, i64CreateTime puede estar en error.

wOriginalXid

El identificador Xid del mensaje original.

wError

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

Valor Significado
DNS_RCODE_BADSIG
 El campo pSignature no es válido.
DNS_RCODE_BADKEY
 El campo pKey del DNS_TKEY_DATA RR es incorrecto.
DNS_RCODE_BADTIME
 Una marca de tiempo es mala.

wSigLength

Longitud, en bytes, del miembro de pSignature.

wOtherLength

Longitud, en bytes, del miembro pOtherData.

cAlgNameLength

Longitud, en bytes, del miembro pAlgorithmPacket.

bPacketPointers

Reservado para uso futuro. No use.

Observaciones

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

Nota

El encabezado windns.h define DNS_TSIG_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_TKEY_DATA