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
备注
如果 WINSPrimaryServer 和 WINSSecondaryServer 都设置为“” (空字符串) ,则显式 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 |
|
DLL |
|