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 成員; [旗標] 欄位必須是空的。

如果您將 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。傳回值不是 0 就表示失敗。