Win32_NetworkAdapterConfiguration 類別的 EnableDHCP 方法
EnableDHCPWMI 類別方法會啟用動態主機組態通訊協定 （DHCP）， 以使用此網路適配器提供服務。 DHCP 允許動態配置IP位址。
本主題使用Managed物件格式 （MOF） 語法。 如需使用此方法的詳細資訊，請參閱 呼叫方法。
語法
uint32 EnableDHCP();
參數
這個方法沒有任何參數。
傳回值
如果不需要重新啟動，則傳回 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
備註
此方法不會清除計算機上存在的任何靜態預設閘道。
範例
下列 VBScript 程式代碼範例示範如何在 Win32_NetworkAdapterConfiguration 實例上啟用 DHCP 使用。 在此情況下，我們會指定索引為0的配接器。 應該從其他介面的Win32_NetworkAdapter實例中選取正確的索引。
注意
僅限 NT 平台上支援。
Set Adapter = GetObject("winmgmts:Win32_NetworkAdapterConfiguration=0")
RetVal = Adapter.EnableDHCP()
if RetVal = 0 then
WScript.Echo "DHCP Enabled"
else
WScript.Echo "DHCP enable failed"
end if
下列 Perl 程式代碼範例示範如何在 Win32_NetworkAdapterConfiguration 實例上啟用 DHCP 使用。 在此情況下，我們會指定索引為0的配接器。 應該從其他介面的Win32_NetworkAdapter實例中選取正確的索引。
注意
僅限 NT 平台上支援。
use strict;
use Win32::OLE;
my ( $Adapter, $RetVal );
eval { $Adapter = Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2")->
Get("Win32_NetworkAdapterConfiguration=0"); };
unless ($@)
{
print "\n";
$RetVal = $Adapter->EnableDHCP();
if ( $RetVal == 0)
{
print "DHCP Enabled\n";
}
else
{
print "DHCP enable failed\n";
}
}
else
{
print STDERR Win32::OLE->LastError, "\n";
}
需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|