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

структура DNS_TKEY_DATAW (windns.h)

  • Статья

Структура DNS_TKEY_DATA представляет запись ресурса TKEY DNS, используемую для установки и удаления общих секретных ключей алгоритма между сопоставителем DNS и сервером, как указано в RFC 2930.

Синтаксис

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;

Члены

pNameAlgorithm

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

pAlgorithmPacket

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

pKey

Указатель на общий секретный ключ переменной длины.

pOtherData

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

dwCreateTime

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

dwExpireTime

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

wMode

Схема, используемая для соглашения ключа или назначения сообщения TKEY DNS. Ниже перечислены возможные значения для wMode .

Значение Значение
DNS_TKEY_MODE_SERVER_ASSIGN
 Ключ назначается DNS-сервером и не согласовывается.
DNS_TKEY_MODE_DIFFIE_HELLMAN
 Для согласования ключа используется алгоритм обмена ключами Diffie-Hellman.
DNS_TKEY_MODE_GSS
Обмен ключом осуществляется через согласование интерфейса программы Services-Application универсальной безопасности (GSS-API).
DNS_TKEY_MODE_RESOLVER_ASSIGN
 Ключ назначается сопоставителем DNS и не согласовывается.

wError

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

Значение Значение
DNS_RCODE_BADSIG
 PSignatureDNS_TSIG_DATA RR является плохим.
DNS_RCODE_BADKEY
 Поле pKey является плохим.
DNS_RCODE_BADTIME
 Метка времени плоха.

wKeyLength

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

wOtherLength

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

cAlgNameLength

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

bPacketPointers

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

Комментарии

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

Примечание

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

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть windns.h

См. также раздел

DNS_RECORD

DNS_TSIG_DATA