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


Функция SetInterfaceDnsSettings (netioapi.h)

Задает параметры DNS для каждого интерфейса, указанные в параметре Параметры .

Синтаксис

NETIOAPI_API SetInterfaceDnsSettings(
  GUID                         Interface,
  const DNS_INTERFACE_SETTINGS *Settings
);

Параметры

Interface

Тип: _In_ GUID

GUID COM-интерфейса, на который ссылаются параметры.

Settings

Тип: _In_ const DNS_INTERFACE_SETTINGS*

Указатель на структуру типа DNS_INTERFACE_SETTINGS, содержащую параметры интерфейса DNS.

Если этот параметр указывает на структуру DNS_INTERFACE_SETTINGS , то для элемента DNS_INTERFACE_SETTINGS::Version должно быть задано значение DNS_INTERFACE_SETTINGS_VERSION1.

Если этот параметр указывает на структуру DNS_INTERFACE_SETTINGS_EX , то для версии необходимо задать значение DNS_INTERFACE_SETTINGS_VERSION2.

Если этот параметр указывает на структуру DNS_INTERFACE_SETTINGS3 , то для версии необходимо задать значение DNS_INTERFACE_SETTINGS_VERSION3.

Необходимо правильно задать все необходимые параметры в поле DNS_INTERFACE_SETTINGS::Flags и заполнить только поля, для которых был задан параметр. Необходимо обнулить все остальные поля, для которых нет соответствующего параметра.

Возвращаемое значение

В случае успешного выполнения возвращает NO_ERROR. Если возвращается значение, отличное от нуля, значит произошел сбой.

Требования

Требование Значение
Минимальная версия клиента сборка Windows 10 19041
Минимальная версия сервера сборка Windows 10 19041
Целевая платформа Windows
Header netioapi.h (включая Iphlpapi.h)
Библиотека Iphlpapi.lib
DLL Iphlpapi.dll

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