netioapi.h) (DNS_DOH_SERVER_SETTINGS 结构

描述 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 结尾的宽字符串,其中包含有效的 DNS-over-HTTPS URI 模板。

如果 存在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 服务器将从系统 DNS-over-HTTPS 系统列表中加载其 URI 模板。 如果存在此选项,则必须将 “模板” 字段设置为 NULL。 此选项不得与 DNS_DOH_SERVER_SETTINGS_ENABLE 选项一起使用。

DNS_DOH_SERVER_SETTINGS_ENABLE (0x0002) 。 如果存在此选项,则 “模板” 字段必须指向有效的 DNS-over-HTTPS URI 模板。 此选项不得与 DNS_DOH_SERVER_SETTINGS_ENABLE_AUTO 选项一起使用。

DNS_DOH_SERVER_SETTINGS_FALLBACK_TO_UDP (0x0004) 。 此选项指示如果 DNS-over-HTTPS 查询失败,引用的服务器可能会回退到不安全的名称解析 (UDP/TCP) 。 除了 DNS_DOH_SERVER_SETTINGS_ENABLE_AUTODNS_DOH_SERVER_SETTINGS_ENABLE之外,此选项只能使用。

DNS_DOH_AUTO_UPGRADE_SERVER (0x0008) 。 如果 NRPT 规则中存在的 DNS 服务器与此属性引用的服务器具有相同的 IP 地址,则此选项允许该服务器使用 DNS-over-HTTPS 模板。 此选项不能单独使用;它必须是 DNS_DOH_SERVER_SETTINGS_ENABLE_AUTODNS_DOH_SERVER_SETTINGS_ENABLE的补充。

要求

要求
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 netioapi.h (包括 Iphlpapi.h)