共用方式為


DNS_INTERFACE_SETTINGS 結構 (netioapi.h)

表示可在指定介面上設定的 DNS 設定,方法是呼叫 SetInterfaceDnsSettings 函式,或藉由呼叫 GetInterfaceDnsSettings 函式來擷取指定介面的 DNS 設定。

語法

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 網路堆疊的介面設定。 如果已設定此選項, 則 NameServerProfileNameServer 成員中指定的任何 IP 位址都必須是 IPv6 位址。 根據預設,此結構中指定的 DNS 介面設定只會套用至 IPv4 網路堆疊。

DNS_SETTING_NAMESERVER (0x0002) 。 透過 NameServer 成員,在指定的介面上設定靜態配接器 DNS 伺服器。

DNS_SETTING_SEARCHLIST (0x0004) 。 透過 SearchList 成員設定指定配接器的連線特定 DNS 後綴搜尋清單。

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) 。 透過 ProfileNameServer 成員,在指定的介面上設定靜態配置檔 DNS 伺服器。

Domain

類型: PWSTR

包含配接器功能變數名稱的NULL終止寬字串。

NameServer

類型: PWSTR

以 NULL 結尾的寬字串,包含一系列逗號或空格分隔的 DNS 伺服器。 例如,L“1.1.1.1 8.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.8” 或 L“1.1.1.1,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)

另請參閱