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

另请参阅

计算机系统硬件类

Win32_NetworkAdapterConfiguration

WMI 任务:网络

WMI 任务:帐户和域

WMI 中的 IPv6 和 IPv4 支持