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	CIMWin32.mof
DLL	CIMWin32.dll

另請參閱

計算機系統硬體類別

Win32_NetworkAdapterConfiguration

WMI 工作：網路

WMI 工作：帳戶和網域

WMI 中的 IPv6 和 IPv4 支援