getInterfaceDnsSettings 函数 (netioapi.h)

从 Interface 参数中指定的 接口检索 DNS 设置。完成返回的设置对象后，必须调用 FreeInterfaceDnsSettings 以释放它。

语法

NETIOAPI_API GetInterfaceDnsSettings(
  GUID                   Interface,
  DNS_INTERFACE_SETTINGS *Settings
);

Interface

类型：_In_ GUID

设置引用的 COM 接口的 GUID 。

Settings

类型：_Inout_ const DNS_INTERFACE_SETTINGS*

GetInterfaceDnsSettings 填充此结构中的所有设置。

应仅设置版本成员; 标志字段必须为空。

如果将 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 。非零返回值指示失败。