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 網路堆疊的介面設定。 如果已設定此選項, 則 NameServer 或 ProfileNameServer 成員中指定的任何 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) |