Метод ReleaseDHCPLease класса Win32_NetworkAdapterConfiguration

Статья
06/12/2023

Метод класса WMIReleaseDHCPLease освобождает IP-адрес, привязанный к определенному сетевому адаптеру с поддержкой DHCP.

В этом разделе используется синтаксис формата управляемого объекта (MOF). Дополнительные сведения об использовании этого метода см. в разделе Вызов метода.

Синтаксис

uint32 ReleaseDHCPLease();

Параметры

Этот метод не имеет параметров.

Возвращаемое значение

Возвращает значение 0 (ноль) для успешного завершения, если перезагрузка не требуется, 1 (одно) для успешного завершения, когда требуется перезагрузка, и другое число при возникновении ошибки. Дополнительные сведения о кодах ошибок см. в разделе Константы ошибок WMI или WbemErrorEnum. Общие значения HRESULT см. в разделе Системные коды ошибок.

Успешное завершение, перезагрузка не требуется

Успешное завершение, перезагрузка не требуется.

Успешное завершение, требуется перезагрузка

Успешное завершение, требуется перезагрузка.

Метод не поддерживается на этой платформе

Метод не поддерживается на этой платформе.

Неизвестный сбой

Неизвестный сбой.

Недопустимая маска подсети

Недопустимая маска подсети.

Ошибка при обработке возвращенного экземпляра

При обработке возвращенного экземпляра произошла ошибка.

Недопустимый входной параметр

Недопустимый входной параметр.

Указано более 5 шлюзов

Указано более пяти шлюзов.

Недопустимый IP-адрес

Недопустимый IP-адрес.

Недопустимый IP-адрес шлюза

Недопустимый IP-адрес шлюза.

Произошла ошибка при доступе к реестру для получения запрошенных сведений

Произошла ошибка при доступе к реестру для получения запрошенных сведений.

Недопустимое доменное имя

Недопустимое доменное имя.

Недопустимое имя узла

Недопустимое имя узла.

Основной или вторичный сервер WINS не определен

Основной или вторичный сервер WINS не определен.

Недопустимый файл

Недопустимый файл.

Недопустимый системный путь

Недопустимый системный путь.

Сбой копирования файла

Сбой копирования файла.

Недопустимый параметр безопасности

Недопустимый параметр безопасности.

Не удалось настроить службу TCP/IP

Не удалось настроить службу TCP/IP.

Не удается настроить службу DHCP

Не удалось настроить службу DHCP.

Не удается продлить аренду DHCP

Не удается продлить аренду DHCP.

Не удается освободить аренду DHCP

Не удается освободить аренду DHCP.

IP-адрес не включен в адаптере

IP-адрес не включен для адаптера.

IpX не включен на адаптере

IPX не включен в адаптере.

Ошибка границ фрейма или сетевого номера

Ошибка границ фрейма или сетевого номера.

Недопустимый тип кадра

Недопустимый тип кадра.

Недопустимый номер сети

Недопустимый номер сети.

Повторяющийся номер сети

Повторяющийся номер сети.

Параметр выходит за пределы границ

Параметр выходит за пределы.

Доступ запрещен

Доступ запрещен.

Недостаточно памяти

Недостаточно памяти.

Уже существует

Уже существует.

Путь, файл или объект не найден

Путь, файл или объект не найден.

Не удалось уведомить службу

Не удалось уведомить службу.

Не удается уведомить службу DNS

Не удалось уведомить службу DNS.

Интерфейс не настраивается

Интерфейс не настраивается.

Не все аренды DHCP могут быть освобождены или продлены

Не все аренды DHCP могут быть освобождены или продлены.

Dhcp не включен на адаптере

100

Dhcp не включен в адаптере.

Другое

101 4294967295

Remarks

Внимание!

Если dhcp включен в локальной системе компьютера, параметр отключает TCP/IP для этого сетевого адаптера. Если у вас нет альтернативного пути к целевой системе, то есть другому сетевому адаптеру, привязанному к TCP/IP, все соединения TCP/IP будут потеряны.

Примеры

В примере Обновления IP-адресов для выпуска с помощью PowerShell PowerShell в коллекции TechNet используется ReleaseDHCPLease для выпуска и обновления IP-адреса.

Следующий код VBScript освобождает аренду DHCP для всех сетевых адаптеров, связанных с TCP/IP на компьютере.

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 
    objNetCard.ReleaseDHCPLease() 
Next

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

См. также раздел

Классы оборудования компьютерной системы
Win32_NetworkAdapterConfiguration
Задачи WMI: сеть
Задачи WMI: учетные записи и домены
Поддержка IPv6 и IPv4 в WMI

Share via