Método EnableStatic da classe Win32_NetworkAdapterConfiguration

O método de classe WMIEnableStatic permite endereçamento TCP/IP estático para o adaptador de rede de destino. Como resultado, o DHCP para esse adaptador de rede está desabilitado.

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 EnableStatic(
  [in] string IPAddress[],
  [in] string SubnetMask[]
);

Parâmetros

IPAddress [in]

Lista todos os endereços IP estáticos para o adaptador de rede atual.

Exemplo: 155.34.22.0.

SubnetMask [in]

Máscaras de sub-rede que complementam os valores no parâmetro IPAddress .

Exemplo: 255.255.0.0.

Valor retornado

Retorna um valor de 0 (zero) para uma conclusão bem-sucedida quando uma reinicialização não é necessária, 1 (um) para uma conclusão bem-sucedida quando uma reinicialização é necessária e qualquer outro número, 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. Para obter mais informações, consulte a seção Comentários.

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.

Memória insuficiente

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

O DHCP não está habilitado no adaptador.

2147786788

Bloqueio de gravação não habilitado. Para obter mais informações, consulte INetCfgLock::AcquireWriteLock.

Outros

101 4294967295

Comentários

Ao usar EnableStatic para alterar o endereço IP do computador remoto, enquanto estiver conectado por meio desse adaptador, você provavelmente perderá a conexão com o computador remoto e receberá uma mensagem de erro RPC não disponível. (no entanto, as configurações são alteradas). Para evitar esse cenário, considere alterar as configurações de Gateway e/ou DNS antes de definir o endereço IP do adaptador.

Ao usar EnableStatic para fornecer a um adaptador uma configuração de IP estático, a função retornará um "81 – Não é possível configurar o serviço DHCP" se o adaptador já estiver configurado com um endereço estático. No entanto, a função ainda é bem-sucedida na configuração com a nova operação.

Exemplos

O IP estático e, em seguida, ingressar em um exemplo de código do PowerShell de domínio, na Galeria do TechNet, usa EnableStatic para adicionar um IP estático a um computador local.

O exemplo de código Atribuir um endereço IP estático VBScript, na Galeria do TechNet, usa EnableStatic para definir o endereço IP de um computador.

O exemplo de VBScript a seguir demonstra como desabilitar o uso de DHCP em uma instância do Win32_NetworkAdapterConfiguration. Nesse caso, especificamos o adaptador com um Índice de 0. O índice correto deve ser selecionado de Win32_NetworkAdapter instâncias para outras interfaces.

Set Adapter = GetObject("winmgmts:Win32_NetworkAdapterConfiguration=1")

ipaddr = Array("1.1.1.1")
subnet = Array("255.255.255.0")


RetVal = Adapter.EnableStatic(ipaddr,subnet)

if RetVal = 0 then 
 WScript.Echo "DHCP disabled, using static IP address"
else 
 WScript.Echo "DHCP disable failed"
end if

O exemplo de Perl a seguir demonstra como desabilitar o uso de DHCP em uma instância do Win32_NetworkAdapterConfiguration. Nesse caso, especificamos o adaptador com um Índice de 0. O índice correto deve ser selecionado de Win32_NetworkAdapter instâncias para outras interfaces.

use strict;
use Win32::OLE;

my ($Adapter, @ipaddr, @subnet, $RetVal);  
eval { $Adapter = 
 Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2:Win32_NetworkAdapterConfiguration.Index=\"0\""); };

unless ($@) 
{
 push @ipaddr, "192.168.144.107";
 push @subnet, "255.255.255.0";

 $RetVal = $Adapter->EnableStatic(\@ipaddr, \@subnet);

 if ($RetVal == 0) 
 {
  print "\nDHCP disabled, using static IP address\n";
 }
 else 
 {
  print "\nDHCP disable failed\n";
 }
}
else
{
 print STDERR "\n", Win32::OLE->LastError, "\n";
}

Requisitos

Confira também

Classes de hardware do sistema de computador

Win32_NetworkAdapterConfiguration

Tarefas do WMI: Rede

Tarefas do WMI: contas e domínios

Suporte a IPv6 e IPv4 no WMI