Win32_NetworkAdapterConfiguration 类的 EnableDNS 方法
EnableDNSWMI 类静态方法为服务启用域名系统 (DNS) 。
本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息，请参阅 调用方法。
语法
uint32 EnableDNS(
[in, optional] string DNSHostName,
[in, optional] string DNSDomain,
[in, optional] string DNSServerSearchOrder[],
[in, optional] string DNSDomainSuffixSearchOrder[]
);
参数
-
DNSHostName [in， optional]
-
此方法启用的 DNS 主机的名称。
示例：“corpdns”
-
DNSDomain [in， optional]
-
表示一个组织名称，后跟一个句点和一个指示组织类型的扩展名。
示例：“microsoft.com”
-
DNSServerSearchOrder [in， optional]
-
要查询 DNS 服务器的服务器 IP 地址列表。
-
DNSDomainSuffixSearchOrder [in， optional]
-
在名称解析期间追加到主机名的 DNS 域后缀。 从仅主机名解析完全限定的域名 (FQDN) 时，系统会追加本地域名。 如果名称解析不成功，系统将使用域后缀列表按列出的顺序创建其他 FQDN，然后查询每个 FQDN 的 DNS 服务器。
返回值
如果不需要重新启动，则返回一个值 0 (零) 的成功完成，在需要重新启动时返回 1 (一个) ，如果出现错误，则返回任何其他数字。 有关错误代码的详细信息，请参阅 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
示例
下面的代码示例取自 TechNet 库 上启用所有网络适配器上的 DNS VBScript 代码示例，为计算机上的所有网络适配器启用 DNS。
On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set objNetworkSettings = objWMIService.Get("Win32_NetworkAdapterConfiguration")
strHostName = "fabrikam1"
arrDNSSuffixes = Array("hr.fabrikam.com", "research.fabrikam.com")
objNetworkSettings.EnableDNS strHostName, , , arrDNSSuffixes
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista |
| 最低受支持的服务器 |
Windows Server 2008 |
| 命名空间 |
Root\CIMV2 |
| MOF |
|
| DLL |
|