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

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

  • Статья

Извлекает параметры DNS из интерфейса, указанного в параметре Interface . Завершив работу с возвращенным объектом settings, необходимо вызвать FreeInterfaceDnsSettings , чтобы освободить его.

Синтаксис

NETIOAPI_API GetInterfaceDnsSettings(
  GUID                   Interface,
  DNS_INTERFACE_SETTINGS *Settings
);

Параметры

Interface

Тип: _In_ GUID

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

Settings

Тип: _Inout_ const DNS_INTERFACE_SETTINGS*

GetInterfaceDnsSettings заполняет все параметры в этой структуре.

Следует задать только элемент Version ; Поле Флаги должно быть пустым.

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

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

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

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

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

Требования

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

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