Método SetWINSServer da classe Win32_NetworkAdapterConfiguration
O método de classe WMISetWINSServer define os servidores WINS (Serviço de Nomenclatura da Internet) primário e secundário do Windows neste adaptador de rede associado a TCP/IP. Esse método é aplicado independentemente do adaptador de rede.
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 SetWINSServer(
[in] string WINSPrimaryServer,
[in] string WINSSecondaryServer
);
Parâmetros
-
WINSPrimaryServer [in]
-
Endereço IP do servidor WINS primário.
Observação
Sempre verifique a validade desse endereço IP quando ele é de uma fonte desconhecida ou uma fonte em que você não confia.
-
WINSSecondaryServer [in]
-
Endereço IP do servidor WINS secundário.
Observação
Sempre verifique a validade desse endereço IP quando ele é de uma fonte desconhecida ou uma fonte em que você não confia.
Valor retornado
Retorna um valor inteiro de 0 (zero) após a conclusão bem-sucedida e qualquer outro número para indicar 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
Se WINSPrimaryServer e WINSSecondaryServer estiverem definidos como "" (uma cadeia de caracteres vazia), os servidores WINS explícitos reverter de volta para DHCP.
Exemplos
Atribuir um endereço IP recuperado de um banco de dados O exemplo de código VBScript pesquisa um computador em um banco de dados e atribui a esse computador o endereço IP especificado.
O exemplo de código VBScript a seguir define o servidor WINS primário e secundário para um adaptador de rede associado a 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
strPrimaryServer = "192.168.1.100"
strSecondaryServer = "192.168.1.200"
objNetCard.SetWINSServer strPrimaryServer, strSecondaryServer
Next
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|