通过

netioapi.h) (DNS_INTERFACE_SETTINGS 结构

  • 项目

表示可通过调用 SetInterfaceDnsSettings 函数在给定接口上配置的 DNS 设置，或通过调用 GetInterfaceDnsSettings 函数为给定接口检索这些设置。

语法

typedef struct _DNS_INTERFACE_SETTINGS {
  ULONG   Version;
  ULONG64 Flags;
  PWSTR   Domain;
  PWSTR   NameServer;
  PWSTR   SearchList;
  ULONG   RegistrationEnabled;
  ULONG   RegisterAdapterName;
  ULONG   EnableLLMNR;
  ULONG   QueryAdapterName;
  PWSTR   ProfileNameServer;
} DNS_INTERFACE_SETTINGS;

成员

Version

类型： ULONG

必须设置为 DNS_INTERFACE_SETTINGS_VERSION1。

Flags

类型： ULONG64

以下选项的位图。

DNS_SETTING_IPV6 (0x0001) 。 仅为 IPv6 网络堆栈配置接口设置。 如果设置了此选项，则 NameServer 或 ProfileNameServer 成员中指定的任何 IP 地址必须是 IPv6 地址。 默认情况下，在此结构中指定的 DNS 接口设置仅应用于 IPv4 网络堆栈。

DNS_SETTING_NAMESERVER (0x0002) 。 通过 NameServer 成员在指定接口上配置静态适配器 DNS 服务器。

DNS_SETTING_SEARCHLIST (0x0004) 。 通过 SearchList 成员为给定适配器配置特定于连接的 DNS 后缀搜索列表。

DNS_SETTING_REGISTRATION_ENABLED (0x0008) 。 启用或禁用给定适配器的动态 DNS 注册。 默认情况下，这是系统启用的。

DNS_SETTING_DOMAIN (0x0020) 。 通过 域 成员为给定适配器配置特定于连接的 DNS 后缀。

DNS_SETTINGS_ENABLE_LLMNR (0x0080) 。 在指定的适配器上使用 LLMNR 和 mDNS 启用或禁用名称解析。 默认情况下，这是系统启用的。

DNS_SETTINGS_QUERY_ADAPTER_NAME (0x0100) 。 启用或禁用将适配器名称用作 DNS 查询的后缀。 默认情况下，这是系统启用的。

DNS_SETTING_PROFILE_NAMESERVER (0x0200) 。 通过 ProfileNameServer 成员在指定接口上配置静态配置文件 DNS 服务器。

Domain

类型： PWSTR

包含适配器域名的以 NULL 结尾的宽字符串。

NameServer

类型： PWSTR

以 NULL 结尾的宽字符串，其中包含一系列逗号或空格分隔的 DNS 服务器。 例如，L“1.1.1.1 8.8.8”或 L“1.1.1.1,8.8.8.8”。

如果 存在DNS_SETTING_IPV6 标志，则服务器必须是 IPv6 地址。 例如，L“2606：4700：4700：：1001,2606：4700：4700：：1111”。

SearchList

类型： PWSTR

以 NULL 结尾的宽字符串，其中包含一系列逗号或空格分隔的搜索名称。 例如，L“contoso1.com contoso2.com”或 L“contoso1.com，contoso2.com”。

RegistrationEnabled

类型： ULONG

如果为 TRUE ，则启用适配器动态注册; 如果为 FALSE ，则禁用它。

RegisterAdapterName

类型： ULONG

如果为 TRUE ，则启用适配器名称注册; 如果为 FALSE ，则禁用它。

EnableLLMNR

类型： ULONG

若要 在给定接口上启用 mDNS 和 LLMNR，则为 TRUE; 如果为 FALSE ，则禁用它们。

QueryAdapterName

类型： ULONG

如果适配器名称应用作搜索后缀，则为 TRUE;否则为 FALSE。

ProfileNameServer

类型： PWSTR

以 NULL 结尾的宽字符串，其中包含一系列逗号或空格分隔的 DNS 服务器。 例如，L“1.1.1.1 8.8.8”或 L“1.1.1.1,8.8.8.8”。

如果 存在DNS_SETTING_IPV6 标志，则服务器必须是 IPv6 地址。 例如，L“2606：4700：4700：：1001,2606：4700：4700：：1111”。

要求

要求 值
最低受支持的客户端 Windows 10内部版本 18362
最低受支持的服务器 Windows 10内部版本 18362
标头 netioapi.h (包括 Iphlpapi.h)

另请参阅