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

Представляет параметры DNS, которые можно настроить в заданном интерфейсе путем вызова функции SetInterfaceDnsSettings или получить для данного интерфейса путем вызова функции 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. Если этот параметр задан, все IP-адреса, указанные в элементах NameServer или ProfileNameServer, должны быть IPv6-адресами. По умолчанию параметры интерфейса DNS, указанные в этой структуре, применяются только к сетевому стеку IPv4.

DNS_SETTING_NAMESERVER (0x0002). Настраивает DNS-серверы статического адаптера на указанном интерфейсе через член NameServer .

DNS_SETTING_SEARCHLIST (0x0004). Настраивает список поиска DNS-суффиксов для конкретного подключения для заданного адаптера с помощью элемента SearchList .

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). Настраивает DNS-серверы статического профиля в указанном интерфейсе с помощью элемента ProfileNameServer .

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

Значение TRUE для включения mDNS и LLMNR в заданном интерфейсе; Значение 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.8".

Если флаг DNS_SETTING_IPV6 присутствует, серверы должны быть IPv6-адресами. Например, L"2606:4700:4700::1001,2606:4700:4700::1111".

Требования

Требование	Значение
Минимальная версия клиента	сборка Windows 10 18362
Минимальная версия сервера	сборка Windows 10 18362
Верхняя часть	netioapi.h (включая Iphlpapi.h)

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

• GetInterfaceDnsSettings
• SetInterfaceDnsSettings