Win32_NetworkAdapterConfiguration 类的 SetDNSServerSearchOrder 方法

SetDNSServerSearchOrderWMI 类方法使用字符串元素数组来设置服务器搜索顺序。

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

语法

uint32 SetDNSServerSearchOrder(
  [in] string DNSServerSearchOrder[]
);

参数

DNSServerSearchOrder [in]

要查询 DNS 服务器的服务器 IP 地址列表。

示例：130.215.24.1 或 157.54.164.1

返回值

如果不需要重新启动，则返回一个值 0 (零) ，如果不需要重新启动，则返回 1 (一个) ，如果出现错误，则返回另一个数字。 有关错误代码的详细信息，请参阅 WMI 错误常量 或 WbemErrorEnum。 有关常规 HRESULT 值，请参阅 系统错误代码。

成功完成，无需重启 (0)

成功完成，需要重新启动 (1)

此平台上不支持的方法 (64)

未知失败 (65)

子网掩码 (66) 无效

处理 (67) 返回的实例时出错

无效的输入参数 (68)

(69) 指定的网关超过 5 个

(70) IP 地址无效

网关 IP 地址 (71) 无效

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

无效的域名 (73)

无效的主机名 (74)

未定义主/辅助 WINS 服务器 (75)

文件 (76) 无效

无效的系统路径 (77)

文件复制失败 (78)

安全参数 (79) 无效

无法配置 TCP/IP 服务 (80)

无法配置 DHCP 服务 (81)

无法续订 DHCP 租约 (82)

无法释放 DHCP 租约 (83)

适配器 (84) 上未启用 IP

适配器 (85) 上未启用 IPX

帧/网络编号边界错误 (86)

无效的帧类型 (87)

无效的网络编号 (88)

重复网络号码 (89)

参数超出边界 (90)

访问被拒绝 (91)

内存不足 (92)

已存在 (93)

找不到路径、文件或对象 (94)

无法通知服务 (95)

无法通知 DNS 服务 (96)

接口不可配置 (97)

并非所有 DHCP 租约都可以释放/续订 (98)

未在适配器上启用 DHCP (100)

其他 (101 4294967295)

备注

这是一个依赖于实例的方法调用，适用于每个适配器。 将静态 DNS 服务器指定为开始使用动态主机配置协议 (DHCP) 而不是静态 DNS 服务器后，无需提供“in”参数即可调用 方法。

示例

TechNet 库中 的“为组织单位 VBScript 中的多台计算机设置 DNS 服务器搜索顺序 ”示例检索或设置属于一个组织单位的多台计算机的 DNS 服务器搜索顺序。

修改网络适配器 VBScript 的 DNS 服务器搜索顺序 示例将 TCP/IP 绑定网络适配器配置为使用两个 DNS 服务器。

要求

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

另请参阅

计算机系统硬件类

Win32_NetworkAdapterConfiguration

WMI 任务：网络

WMI 任务：帐户和域

WMI 中的 IPv6 和 IPv4 支持