Método ReleaseDHCPLease da classe Win32_NetworkAdapterConfiguration
O método de classe WMIReleaseDHCPLease libera o endereço IP associado a um adaptador de rede habilitado para DHCP específico.
Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.
Sintaxe
uint32 ReleaseDHCPLease();
Parâmetros
Esse método não tem parâmetros.
Valor retornado
Retorna um valor de 0 (zero) para uma conclusão bem-sucedida quando nenhuma reinicialização é necessária, 1 (um) para uma conclusão bem-sucedida quando uma reinicialização é necessária e um número diferente se houver um erro. Para obter mais informações sobre códigos de erro, consulte Constantes de erro WMI ou WbemErrorEnum. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.
-
Conclusão bem-sucedida, nenhuma reinicialização necessária
-
0
Conclusão bem-sucedida, nenhuma reinicialização necessária.
-
Conclusão bem-sucedida, reinicialização necessária
-
1
Conclusão bem-sucedida, reinicialização necessária.
-
Método sem suporte nesta plataforma
-
64
Método sem suporte nesta plataforma.
-
Falha desconhecida
-
65
Falha desconhecida.
-
Máscara de sub-rede inválida
-
66
Máscara de sub-rede inválida.
-
Ocorreu um erro ao processar uma Instância que foi retornada
-
67
Ocorreu um erro ao processar uma instância que foi retornada.
-
Parâmetro de entrada inválido
-
68
Parâmetro de entrada inválido.
-
Mais de 5 gateways especificados
-
69
Mais de cinco gateways especificados.
-
Endereço IP inválido
-
70
Endereço IP inválido.
-
Endereço IP do gateway inválido
-
71
Endereço IP do gateway inválido.
-
Ocorreu um erro ao acessar o Registro para obter as informações solicitadas
-
72
Ocorreu um erro ao acessar o registro para obter as informações solicitadas.
-
Nome de domínio inválido
-
73
Nome de domínio inválido.
-
Nome do host inválido
-
74
Nome do host inválido.
-
Nenhum servidor WINS primário/secundário definido
-
75
Nenhum servidor WINS primário ou secundário definido.
-
Arquivo inválido
-
76
Arquivo inválido.
-
Caminho do sistema inválido
-
77
Caminho do sistema inválido.
-
Falha na cópia do arquivo
-
78
Falha na cópia do arquivo.
-
Parâmetro de segurança inválido
-
79
Parâmetro de segurança inválido.
-
Não é possível configurar o serviço TCP/IP
-
80
Não é possível configurar o serviço TCP/IP.
-
Não é possível configurar o serviço DHCP
-
81
Não é possível configurar o serviço DHCP.
-
Não é possível renovar a concessão do DHCP
-
82
Não é possível renovar a concessão do DHCP.
-
Não é possível liberar a concessão do DHCP
-
83
Não é possível liberar a concessão do DHCP.
-
IP não habilitado no adaptador
-
84
IP não habilitado no adaptador.
-
IPX não habilitado no adaptador
-
85
IPX não habilitado no adaptador.
-
Erro de limites de número de quadro/rede
-
86
Erro de limites de quadro ou número de rede.
-
Tipo de quadro inválido
-
87
Tipo de quadro inválido.
-
Número de rede inválido
-
88
Número de rede inválido.
-
Número de rede duplicado
-
89
Número de rede duplicado.
-
Parâmetro fora dos limites
-
90
Parâmetro fora dos limites.
-
Acesso negado
-
91
Acesso negado.
-
Sem memória
-
92
Sem memória.
-
Já existe
-
93
Já existe.
-
Caminho, arquivo ou objeto não encontrado
-
94
Caminho, arquivo ou objeto não encontrado.
-
Não é possível notificar o serviço
-
95
Não é possível notificar o serviço.
-
Não é possível notificar o serviço DNS
-
96
Não é possível notificar o serviço DNS.
-
Interface não configurável
-
97
Interface não configurável.
-
Nem todas as concessões dhcp poderiam ser liberadas/renovadas
-
98
Nem todas as concessões dhcp poderiam ser liberadas ou renovadas.
-
DHCP não habilitado no adaptador
-
100
DHCP não habilitado no adaptador.
-
Outros
-
101 4294967295
Comentários
Cuidado
Se o DHCP estiver habilitado no sistema de computador local, a opção desabilita TCP/IP nesse adaptador de rede específico. A menos que você tenha um caminho alternativo para o sistema de destino, ou seja, outro adaptador de rede associado a TCP/IP, todas as comunicações TCP/IP serão perdidas.
Exemplos
O exemplo Renovar Endereços IP de Renovação de Versão usando o PowerShell do PowerShell na Galeria do TechNet usa ReleaseDHCPLease para lançar e renovar um endereço IP.
O código VBScript a seguir libera as concessões DHCP para todos os adaptadores de rede associados a TCP/IP em um computador.
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
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|