структура DNS_TSIG_DATAW (windnsdef.h)

Статья
01/15/2025

Структура DNS_TSIG_DATA представляет запись ресурсов проверки подлинности транзакций секретного ключа (TSIG), как указано в RFC 2845 и RFC 3645.

Синтаксис

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;

Члены

pNameAlgorithm

Указатель на строку, представляющую имя ключа, используемого для создания pSignature, как определено в разделе 2.3 RFC 2845.

pAlgorithmPacket

Указатель на строку, представляющую имя алгоритма, используемого для создания pSignature, как определено в разделе 2.3 RFC 2845.

Ценность	Значение
"gss.microsoft.com"	Только Сервер Windows 2000: универсальный алгоритм службы безопасности для проверки подлинности транзакций секретного ключа для DNS (GSS-API), как определено в RFC 3645.
"gss-tsig"	Универсальный алгоритм службы безопасности для проверки подлинности транзакции секретного ключа для DNS (GSS-API), как определено в RFC 3645.

pSignature

Указатель на код проверки подлинности сообщений (MAC), созданный алгоритмом в pAlgorithmPacket. Длина, в байтах и композиция pSignature определяются pAlgorithmPacket.

pOtherData

Если wError содержит RCODE, BADTIME, pOtherData — это массив BYTE, содержащий текущее время сервера, в противном случае NULL. Время выражается в секундах с начала 1 января 1970 года, Среднее время Гринвича (GMT), за исключением секунд с прыжка.

i64CreateTime

Время создания pSignature, выраженное в секундах с начала 1 января 1970 года, Среднее время Гринвича (GMT), за исключением секунд прыжка.

wFudgeTime

Время в секундах i64CreateTime может быть ошибкой.

wOriginalXid

Идентификатор Сид исходного сообщения.

wError

Ошибка, выраженная в расширенном формате RCODE, охватывающего обработку TSIG и TKEY RR.

Ценность	Значение
DNS_RCODE_BADSIG	Поле pSignature плохо.
DNS_RCODE_BADKEY	Поле pKeyDNS_TKEY_DATA RR плохо.
DNS_RCODE_BADTIME	Метка времени плоха.

wSigLength

Длина элемента pSignature в байтах.

wOtherLength

Длина в байтах элемента pOtherData.

cAlgNameLength

Длина в байтах элемента pAlgorithmPack et.

bPacketPointers

Зарезервировано для дальнейшего использования. Не используйте.

Замечания

Структура DNS_TSIG_DATA используется вместе со структурой DNS_RECORD для программного управления записями DNS.

Заметка

Заголовок windns.h определяет DNS_TSIG_DATA как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	windnsdef.h

См. также

DNS_RECORD

DNS_TKEY_DATA

Поделиться через