Win32_NetworkAdapterConfiguration 类的 SetWINSServer 方法

SetWINSServerWMI 类方法在此 TCP/IP 绑定网络适配器上设置主要和辅助 Windows Internet 命名服务 (WINS) 服务器。 此方法独立于网络适配器应用。

本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息,请参阅 调用方法

语法

uint32 SetWINSServer(
  [in] string WINSPrimaryServer,
  [in] string WINSSecondaryServer
);

参数

WINSPrimaryServer [in]

主 WINS 服务器的 IP 地址。

注意

如果此 IP 地址来自未知源或你不信任的源,请始终验证其有效性。

WINSSecondaryServer [in]

辅助 WINS 服务器的 IP 地址。

注意

如果此 IP 地址来自未知源或你不信任的源,请始终验证其有效性。

返回值

在成功完成时返回 0 (零) 的整数值,以及指示错误的任何其他数字。 有关错误代码的详细信息,请参阅 WMI 错误常量WbemErrorEnum。 有关常规 HRESULT 值,请参阅 系统错误代码

成功完成,无需重启

0

成功完成,无需重启。

成功完成,需要重新启动

1

成功完成,需要重新启动。

此平台上不支持的方法

64

此平台不支持方法。

未知失败

65

未知失败。

子网掩码无效

66

子网掩码无效。

处理返回的实例时出错

67

处理返回的实例时出错。

无效的输入参数

68

输入参数无效。

指定的网关数超过 5 个

69

指定的网关超过 5 个。

无效的 IP 地址

70

IP 地址无效。

网关 IP 地址无效

71

网关 IP 地址无效。

访问注册表以获取请求的信息时出错

72

访问注册表以获取请求的信息时出错。

无效的域名

73

无效的域名。

主机名无效

74

主机名无效。

未定义主/辅助 WINS 服务器

75

未定义主 WINS 服务器或辅助 WINS 服务器。

文件无效

76

文件无效。

系统路径无效

77

系统路径无效。

文件复制失败

78

文件复制失败。

无效的安全参数

79

无效的安全参数。

无法配置 TCP/IP 服务

80

无法配置 TCP/IP 服务。

无法配置 DHCP 服务

81

无法配置 DHCP 服务。

无法续订 DHCP 租约

82

无法续订 DHCP 租约。

无法释放 DHCP 租约

83

无法释放 DHCP 租约。

适配器上未启用 IP

84

适配器上未启用 IP。

适配器上未启用 IPX

85

适配器上未启用 IPX。

帧/网络编号边界错误

86

帧或网络编号边界错误。

无效的帧类型

87

无效的帧类型。

网络号码无效

88

网络号无效。

重复的网络号码

89

重复的网络编号。

参数超出边界

90

参数超出边界。

访问被拒绝

91

访问被拒绝。

内存不足

92

内存不足。

已存在

93

已存在。

找不到路径、文件或对象

94

找不到路径、文件或对象。

无法通知服务

95

无法通知服务。

无法通知 DNS 服务

96

无法通知 DNS 服务。

接口不可配置

97

接口不可配置。

并非所有 DHCP 租约都可以发布/续订

98

并非所有 DHCP 租约都可以释放或续订。

适配器上未启用 DHCP

100

适配器上未启用 DHCP。

其他

101 4294967295

备注

如果 WINSPrimaryServerWINSSecondaryServer 都设置为“” (空字符串) ,则显式 WINS 服务器还原回 DHCP。

示例

分配从数据库检索到的 IP 地址 VBScript 代码示例在数据库中查找计算机,并为该计算机分配指定的 IP 地址。

以下 VBScript 代码示例设置 TCP/IP 绑定网络适配器的主 WINS 服务器和辅助 WINS 服务器。

On Error Resume Next 
 
strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
 
Set colNetCards = objWMIService.ExecQuery _ 
    ("Select * From Win32_NetworkAdapterConfiguration Where IPEnabled = True") 
 
For Each objNetCard in colNetCards 
    strPrimaryServer = "192.168.1.100" 
    strSecondaryServer = "192.168.1.200" 
    objNetCard.SetWINSServer strPrimaryServer, strSecondaryServer 
Next 

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
命名空间
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

另请参阅

计算机系统硬件类

Win32_NetworkAdapterConfiguration

WMI 任务:网络

WMI 任务:帐户和域

WMI 中的 IPv6 和 IPv4 支持