Win32_NetworkAdapterConfiguration 類別的 EnableStatic 方法
EnableStaticWMI 類別方法會啟用目標網路適配器的靜態 TCP/IP 位址。 因此,此網路適配器的 DHCP 已停用。
本主題使用Managed物件格式 (MOF) 語法。 如需使用此方法的詳細資訊,請參閱 呼叫方法。
語法
uint32 EnableStatic(
[in] string IPAddress[],
[in] string SubnetMask[]
);
參數
-
IPAddress [in]
-
列出目前網路適配器的所有靜態IP位址。
範例:155.34.22.0。
-
SubnetMask [in]
-
子網掩碼,可補充IPAddress參數中的值。
範例:255.255.0.0。
傳回值
如果不需要重新啟動,則傳回 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。
-
2147786788
-
未啟用寫入鎖定。 如需詳細資訊,請參閱 INetCfgLock::AcquireWriteLock。
-
其他
-
101 4294967295
備註
使用 EnableStatic 變更遠端電腦的 IP 位址時,透過該適配卡連線時,您可能會鬆散連線到遠端電腦,並收到 RPC 無法使用的錯誤訊息。 (不過,這些設定已變更)。 若要避免這種情況,請考慮在設定配接器的IP位址之前變更閘道和/或 DNS 設定。
使用 EnableStatic 為配接器提供靜態 IP 組態時,如果配接器已設定靜態位址,則函式會傳回「81 - 無法設定 DHCP 服務」。 不過,函式仍會成功設定新的作業。
範例
下列 VBScript 範例示範如何在 Win32_NetworkAdapterConfiguration 實例上停用 DHCP 使用。 在此情況下,我們會指定索引為0的配接器。 應該從其他介面的Win32_NetworkAdapter實例中選取正確的索引。
注意
此腳本僅適用於 NT 型系統 將下方的 ipaddr 和子網變數變更為您想要套用至配接器的值。
Set Adapter = GetObject("winmgmts:Win32_NetworkAdapterConfiguration=1")
ipaddr = Array("1.1.1.1")
subnet = Array("255.255.255.0")
RetVal = Adapter.EnableStatic(ipaddr,subnet)
if RetVal = 0 then
WScript.Echo "DHCP disabled, using static IP address"
else
WScript.Echo "DHCP disable failed"
end if
下列 Perl 範例示範如何在 Win32_NetworkAdapterConfiguration 實例上停用 DHCP 使用。 在此情況下,我們會指定索引為0的配接器。 應該從其他介面的Win32_NetworkAdapter實例中選取正確的索引。
注意
此腳本僅適用於 NT 型系統 將下方的 ipaddr 和子網變數變更為您想要套用至配接器的值。
use strict;
use Win32::OLE;
my ($Adapter, @ipaddr, @subnet, $RetVal);
eval { $Adapter =
Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2:Win32_NetworkAdapterConfiguration.Index=\"0\""); };
unless ($@)
{
push @ipaddr, "192.168.144.107";
push @subnet, "255.255.255.0";
$RetVal = $Adapter->EnableStatic(\@ipaddr, \@subnet);
if ($RetVal == 0)
{
print "\nDHCP disabled, using static IP address\n";
}
else
{
print "\nDHCP disable failed\n";
}
}
else
{
print STDERR "\n", Win32::OLE->LastError, "\n";
}
需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
Namespace |
Root\CIMV2 |
MOF |
|
DLL |
|