Win32_NetworkAdapterConfiguration 類別的 SetGateways 方法

SetGatewaysWMI類別方法會指定閘道清單,以便將封包路由傳送至與網路介面卡所連線子網不同的子網。

本主題使用 Managed 物件格式 (MOF) 語法。 如需使用此方法的詳細資訊,請參閱 呼叫方法

語法

uint32 SetGateways(
  [in]           string DefaultIPGateway[],
  [in, optional] uint16 GatewayCostMetric[]
);

參數

DefaultIPGateway [in]

路由傳送網路封包之閘道的 IP 位址清單。

GatewayCostMetric [in, 選擇性]

指派範圍從 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。

範例

修改網路介面卡VBScript 的閘道範例會設定網路介面卡的兩個閘道。

指派靜態 IP 位址VBScript 範例會設定電腦的 IP 位址和閘道。

靜態 IP,然後加入網域PowerShell 範例可協助重建機器。

規格需求

需求
最低支援的用戶端
Windows Vista
最低支援的伺服器
Windows Server 2008
命名空間
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

另請參閱

電腦系統硬體類別

Win32_NetworkAdapterConfiguration

WMI 工作:網路

WMI 工作:帳戶和網域

WMI 中的 IPv6 和 IPv4 支援