Win32_NetworkAdapterConfiguration 类的 EnableDHCP 方法
EnableDHCPWMI 类方法为此网络适配器的服务启用动态主机配置协议 (DHCP) 。 DHCP 允许动态分配 IP 地址。
本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息，请参阅 调用方法。
语法
uint32 EnableDHCP();
参数
此方法没有任何参数。
返回值
如果不需要重新启动，则为成功完成返回 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 库中 的启用 DHCP 和分配 DNS 服务器 VBScript 代码示例使用 EnableDHCP 启用 DHCP 并将 DNS 服务器分配给计算机。
以下 VBScript 代码示例演示如何在 Win32_NetworkAdapterConfiguration 实例上启用 DHCP。 在本例中，我们指定索引为 0 的适配器。 应从其他接口的Win32_NetworkAdapter实例中选择正确的索引。
注意
仅在 NT 平台上受支持。
Set Adapter = GetObject("winmgmts:Win32_NetworkAdapterConfiguration=0")
RetVal = Adapter.EnableDHCP()
if RetVal = 0 then
WScript.Echo "DHCP Enabled"
else
WScript.Echo "DHCP enable failed"
end if
以下 Perl 代码示例演示如何在 Win32_NetworkAdapterConfiguration 实例上启用 DHCP。 在本例中，我们指定索引为 0 的适配器。 应从其他接口的Win32_NetworkAdapter实例中选择正确的索引。
注意
仅在 NT 平台上受支持。
use strict;
use Win32::OLE;
my ( $Adapter, $RetVal );
eval { $Adapter = Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2")->
Get("Win32_NetworkAdapterConfiguration=0"); };
unless ($@)
{
print "\n";
$RetVal = $Adapter->EnableDHCP();
if ( $RetVal == 0)
{
print "DHCP Enabled\n";
}
else
{
print "DHCP enable failed\n";
}
}
else
{
print STDERR Win32::OLE->LastError, "\n";
}
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista |
| 最低受支持的服务器 |
Windows Server 2008 |
| 命名空间 |
Root\CIMV2 |
| MOF |
|
| DLL |
|