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

Статья
06/12/2023

Метод класса WMI RenewDHCPLease обновляет IP-адрес на определенных сетевых адаптерах с поддержкой DHCP.

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

Синтаксис

uint32 RenewDHCPLease();

Параметры

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

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

Возвращает значение 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

Аренда IP-адреса, назначенного DHCP-сервером, имеет дату окончания срока действия, которую клиент должен продлить, если он намерен продолжать использовать назначенный IP-адрес.

Примеры

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

В примере возобновления аренды DHCP для сетевого адаптера VBScript в коллекции TechNet используется RenewDHCPLease для продления аренды DHCP для каждого сетевого адаптера, связанного с TCP/IP на компьютере.

Требования

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

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

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

Share via