Win32_NetworkAdapterConfiguration 類別的 SetGateways 方法
SetGatewaysWMI 類別方法會指定閘道清單,以將封包路由傳送至與網路適配器所連線子網不同的子網。
本主題使用Managed物件格式 (MOF) 語法。 如需使用此方法的詳細資訊,請參閱 呼叫方法。
語法
uint32 SetGateways(
[in] string DefaultIPGateway[],
[in, optional] uint16 GatewayCostMetric[]
);
參數
-
DefaultIPGateway [in]
-
路由傳送網路封包之閘道的IP位址清單。
-
GatewayCostMetric [in, optional]
-
指派範圍從 1 到 9999 的值,這個值用來計算最快速且最可靠的路由。 此參數的值會對應至 DefaultIPGateway 參數中的值。 閘道的預設值為 1。
傳回值
當不需要重新啟動時,傳回 0 (零) 的值,當重新啟動不需要時,傳回 1 (一個) 表示成功完成,如果發生錯誤,則傳回任何其他值。 如需錯誤碼的詳細資訊,請參閱 WMI 錯誤常數或 WbemErrorEnum。 如需一般 HRESULT 值,請參閱 系統錯誤碼。
-
成功完成,不需要重新啟動
-
0
-
成功完成,需要重新啟動
-
1
-
此平臺上不支援的方法
-
64
當 NIC 處於 DHCP 模式時,不支援方法。
-
未知的失敗
-
65
-
無效的子網掩碼
-
66
-
處理傳回的實例時發生錯誤
-
67
-
無效的輸入參數
-
68
-
超過 5 個指定的閘道
-
69
-
無效的IP位址
-
70
-
無效的閘道IP位址
-
71
-
存取登錄以取得要求資訊時發生錯誤
-
72
-
無效的功能變數名稱
-
73
-
無效的主機名
-
74
-
未定義主要/次要 WINS 伺服器
-
75
-
無效的檔案
-
76
-
無效的系統路徑
-
77
-
檔案複製失敗
-
78
-
無效的安全性參數
-
79
-
無法設定 TCP/IP 服務
-
80
-
無法設定 DHCP 服務
-
81
-
無法更新 DHCP 租用
-
82
-
無法釋放 DHCP 租用
-
83
-
配接器上未啟用IP
-
84
-
配接器上未啟用IPX
-
85
-
框架/網路號碼界限錯誤
-
86
-
無效的框架類型
-
87
-
無效的網路號碼
-
88
-
重複的網路號碼
-
89
-
參數超出界限
-
90
-
拒絕存取
-
91
-
記憶體不足
-
92
-
已經存在
-
93
-
找不到路徑、檔案或物件
-
94
-
無法通知服務
-
95
-
無法通知 DNS 服務
-
96
-
介面無法設定
-
97
-
並非所有 DHCP 租用都可以釋出/更新
-
98
-
配接器上未啟用 DHCP
-
100
-
其他
-
101 4294967295
備註
只有在網路適配器 (NIC) 處於靜態IP模式時,這個方法才有效。
若要清除閘道,請將閘道設定為您在 EnableStatic 上使用的相同 IP。
需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
Namespace |
Root\CIMV2 |
MOF |
|
DLL |
|