Метод EnableDHCP класса Win32_NetworkAdapterConfiguration
Метод класса WMIEnableDHCP включает протокол DHCP для обслуживания с этим сетевым адаптером. DHCP позволяет динамически выделять IP-адреса.
В этом разделе используется синтаксис MOF. Дополнительные сведения об использовании этого метода см. в разделе Вызов метода .
Синтаксис
uint32 EnableDHCP();
Параметры
Этот метод не имеет параметров.
Возвращаемое значение
Возвращает значение 0 (ноль) для успешного завершения, если перезагрузка не требуется, 1 (один) для успешного завершения, когда требуется перезагрузка, и любое другое число, если возникает ошибка. Дополнительные сведения о кодах ошибок см. в разделе Константы ошибок WMI или WbemErrorEnum. Общие значения HRESULT см. в разделе Системные коды ошибок.
-
Успешное завершение, перезагрузка не требуется
-
0
Успешное завершение, перезагрузка не требуется.
-
Успешное завершение, требуется перезагрузка
-
1
Успешное завершение, требуется перезагрузка.
-
Метод не поддерживается на этой платформе
-
64
Метод не поддерживается на этой платформе.
-
Неизвестный сбой
-
65
Неизвестный сбой.
-
Недопустимая маска подсети
-
66
Недопустимая маска подсети.
-
Ошибка при обработке возвращенного экземпляра
-
67
Ошибка при обработке возвращенного экземпляра.
-
Недопустимый входной параметр
-
68
Недопустимый входной параметр.
-
Указано более 5 шлюзов
-
69
Указано более пяти шлюзов.
-
Недопустимый IP-адрес
-
70
Недопустимый IP-адрес.
-
Недопустимый IP-адрес шлюза
-
71
Недопустимый IP-адрес шлюза.
-
Произошла ошибка при доступе к реестру для получения запрошенных сведений.
-
72
Произошла ошибка при доступе к реестру для запрашиваемых сведений.
-
Недопустимое доменное имя
-
73
Недопустимое доменное имя.
-
Недопустимое имя узла
-
74
Недопустимое имя узла.
-
Основной или вторичный сервер WINS не определен
-
75
Основной или вторичный сервер 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
Комментарии
Этот метод не очищает статические шлюзы по умолчанию, присутствующие на компьютере.
Примеры
Пример кода VBScript для включения DHCP и назначения DNS-серверов в коллекции TechNet использует EnableDHCP для включения DHCP и назначения DNS-серверов компьютеру.
В следующем примере кода VBScript показано, как включить использование DHCP на экземпляре Win32_NetworkAdapterConfiguration . В этом случае мы указываем адаптер с индексом 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 показано, как включить использование DHCP на экземпляре Win32_NetworkAdapterConfiguration . В этом случае мы указываем адаптер с индексом 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 |
|