Win32_NetworkAdapterConfiguration 类的 SetGateways 方法
SetGatewaysWMI 类方法指定网关列表,用于将数据包路由到与网络适配器连接到的子网不同的子网。
本主题使用托管对象格式 (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。
示例
修改网络适配器 VBScript 的网关 示例为网络适配器配置两个网关。
分配静态 IP 地址 VBScript 示例设置计算机的 IP 地址和网关。
静态 IP,然后加入域 PowerShell 示例有助于重新生成计算机。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista |
最低受支持的服务器 |
Windows Server 2008 |
命名空间 |
Root\CIMV2 |
MOF |
|
DLL |
|