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

структура DNS_DOH_SERVER_SETTINGS (netioapi.h)

  • Статья

Описывает сервер DNS-over-HTTPS.

Синтаксис

typedef struct _DNS_DOH_SERVER_SETTINGS {
#if ...
  PWSTR   Template;
#else
  PWSTR   Template;
#endif
  ULONG64 Flags;
} DNS_DOH_SERVER_SETTINGS;

Члены

Template

Тип: PWSTR

Строка с завершением NULL, содержащая допустимый шаблон URI DNS-over-HTTPS.

Если флаг DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO присутствует, это поле должно иметь значение NULL.

Важно!

Шаблон URI не должен содержать IP-адрес в качестве имени узла, который отличается от IP-адреса указанного сервера. Например, если сервер, на который указывает ссылка, — 1.1.1.1, а шаблон URI — https://1.0.0.1/dns-query, то это будет недопустимо, так как 1.0.0.1 не соответствует IP-адресу сервера 1.1.1.1.

Flags

Тип: ULONG64

Растровое изображение, содержащее любой из следующих параметров.

DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO (0x0001). Если этот параметр присутствует, DNS-сервер, на который ссылается это свойство, загрузит шаблон URI из системного списка DNS-over-HTTPS. При наличии этого параметра для поля Шаблон необходимо задать значение NULL. Этот параметр не должен использоваться вместе с параметром DNS_DOH_SERVER_SETTINGS_ENABLE .

DNS_DOH_SERVER_SETTINGS_ENABLE (0x0002). Если этот параметр присутствует, то поле Шаблон должно указывать на допустимый шаблон URI DNS-over-HTTPS. Этот параметр не следует использовать вместе с параметром DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO .

DNS_DOH_SERVER_SETTINGS_FALLBACK_TO_UDP (0x0004). Этот параметр указывает, что указанный сервер может вернуться к незащищенным разрешениям имен (UDP/TCP), если запрос DNS-over-HTTPS завершился ошибкой. Этот параметр можно использовать только в дополнение к DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO или DNS_DOH_SERVER_SETTINGS_ENABLE.

DNS_DOH_AUTO_UPGRADE_SERVER (0x0008). Этот параметр позволяет DNS-серверу, присутствуют в правиле NRPT, использовать шаблон DNS-over-HTTPS, если он имеет тот же IP-адрес, что и сервер, на который ссылается это свойство. Этот параметр нельзя использовать сам по себе; Оно должно быть в дополнение к DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO или DNS_DOH_SERVER_SETTINGS_ENABLE.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть netioapi.h (включая Iphlpapi.h)