Win32_NetworkAdapterConfiguration 類別的 EnableDNS 方法
EnableDNSWMI 類別靜態方法會啟用服務的域名系統（DNS）。
本主題使用Managed物件格式 （MOF） 語法。 如需使用此方法的詳細資訊，請參閱 呼叫方法。
語法
uint32 EnableDNS(
[in, optional] string DNSHostName,
[in, optional] string DNSDomain,
[in, optional] string DNSServerSearchOrder[],
[in, optional] string DNSDomainSuffixSearchOrder[]
);
參數
-
DNSHostName [in， optional]
-
這個方法啟用的 DNS 主機名稱。
範例：“corpdns”
-
DNSDomain [in， optional]
-
代表組織名稱，後面接著句號和表示組織類型的延伸模組。
範例：“microsoft.com”
-
DNSServerSearchOrder [in， optional]
-
要查詢 DNS 伺服器的伺服器 IP 位址清單。
-
DNSDomainSuffixSearchOrder [in， optional]
-
在名稱解析期間附加至主機名的 DNS 網域後綴。 從僅限主機名解析完整功能變數名稱 （FQDN） 時，系統會附加本機功能變數名稱。 如果名稱解析不成功，系統會使用網域後綴清單，依列出的順序建立其他 FQDN，然後查詢每個 FQDN 的 DNS 伺服器。
傳回值
如果不需要重新啟動，則傳回 0 （零） 的值，表示重新啟動不需要時成功完成，若需要重新啟動則傳回 1（一個），如果發生錯誤，則傳回任何其他數位。 如需錯誤碼的詳細資訊，請參閱 WMI 錯誤常數或 WbemErrorEnum。 如需一般 HRESULT 值，請參閱 系統錯誤碼。
-
成功完成，不需要重新啟動
-
0
成功完成，不需要重新啟動。
-
成功完成，需要重新啟動
-
1
成功完成，需要重新啟動。
-
此平臺上不支援的方法
-
64
這個平臺不支援的方法。
-
未知的失敗
-
65
未知的失敗。
-
無效的子網掩碼
-
66
無效的子網掩碼。
-
處理傳回的實例時發生錯誤
-
67
處理傳回的實例時發生錯誤。
-
無效的輸入參數
-
68
無效的輸入參數。
-
超過 5 個指定的閘道
-
69
指定了五個以上的閘道。
-
無效的IP位址
-
70
無效的IP位址。
-
無效的閘道IP位址
-
71
無效的閘道IP位址。
-
存取登錄以取得要求資訊時發生錯誤
-
72
存取所要求資訊的登錄時發生錯誤。
-
無效的功能變數名稱
-
73
無效的功能變數名稱。
-
無效的主機名
-
74
無效的主機名。
-
未定義主要/次要 WINS 伺服器
-
75
未定義主要或次要 WINS 伺服器。
-
無效的檔案
-
76
檔案無效。
-
無效的系統路徑
-
77
無效的系統路徑。
-
檔案複製失敗
-
78
檔案複製失敗。
-
無效的安全性參數
-
79
無效的安全性參數。
-
無法設定 TCP/IP 服務
-
80
無法設定 TCP/IP 服務。
-
無法設定 DHCP 服務
-
81
無法設定 DHCP 服務。
-
無法更新 DHCP 租用
-
82
無法更新 DHCP 租用。
-
無法釋放 DHCP 租用
-
83
無法釋放 DHCP 租用。
-
配接器上未啟用IP
-
84
適配卡上未啟用IP。
-
配接器上未啟用IPX
-
85
配接器上未啟用IPX。
-
框架/網路號碼界限錯誤
-
86
框架或網路號碼界限錯誤。
-
無效的框架類型
-
87
無效的框架類型。
-
無效的網路號碼
-
88
無效的網路號碼。
-
重複的網路號碼
-
89
重複的網路號碼。
-
參數超出界限
-
90
超出界限的參數。
-
拒絕存取
-
91
拒絕存取。
-
記憶體不足
-
92
記憶體不足。
-
已經存在
-
93
已經存在。
-
找不到路徑、檔案或物件
-
94
找不到路徑、檔案或物件。
-
無法通知服務
-
95
無法通知服務。
-
無法通知 DNS 服務
-
96
無法通知 DNS 服務。
-
介面無法設定
-
97
介面無法設定。
-
並非所有 DHCP 租用都可以釋出/更新
-
98
並非所有 DHCP 租用都可以釋出或更新。
-
配接器上未啟用 DHCP
-
100
適配卡上未啟用 DHCP。
-
其他
-
101 4294967295
範例
下列程式代碼範例會針對計算機上的所有網路適配器啟用 DNS。
On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set objNetworkSettings = objWMIService.Get("Win32_NetworkAdapterConfiguration")
strHostName = "fabrikam1"
arrDNSSuffixes = Array("hr.fabrikam.com", "research.fabrikam.com")
objNetworkSettings.EnableDNS strHostName, , , arrDNSSuffixes
需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|