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

另請參閱

計算機系統硬體類別

Win32_NetworkAdapterConfiguration

WMI 工作：網路

WMI 工作：帳戶和網域

WMI 中的 IPv6 和 IPv4 支援