Método SetDNSServerSearchOrder da classe Win32_NetworkAdapterConfiguration

O método de classe WMISetDNSServerSearchOrder usa uma matriz de elementos de cadeia de caracteres para definir a ordem de pesquisa do servidor.

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 SetDNSServerSearchOrder(
  [in] string DNSServerSearchOrder[]
);

Parâmetros

DNSServerSearchOrder [in]

Lista de endereços IP do servidor a serem consultados para servidores DNS.

Exemplo: 130.215.24.1 ou 157.54.164.1

Valor retornado

Retorna um valor 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, reinicialização necessária (1)

Método sem suporte nesta plataforma (64)

Falha desconhecida (65)

Máscara de sub-rede inválida (66)

Erro ao processar uma Instância retornada (67)

Parâmetro de entrada inválido (68)

Mais de 5 gateways especificados (69)

Endereço IP inválido (70)

Endereço IP de gateway inválido (71)

Erro ao acessar o Registro para obter as informações solicitadas (72)

Nome de domínio inválido (73)

Nome de host inválido (74)

Nenhum servidor WINS primário/secundário definido (75)

Arquivo inválido (76)

Caminho do sistema inválido (77)

Falha na cópia do arquivo (78)

Parâmetro de segurança inválido (79)

Não é possível configurar o serviço TCP/IP (80)

Não é possível configurar o serviço DHCP (81)

Não é possível renovar a concessão de DHCP (82)

Não é possível liberar a concessão de DHCP (83)

IP não habilitado no adaptador (84)

IPX não habilitado no adaptador (85)

Erro de limites de número de quadro/rede (86)

Tipo de quadro inválido (87)

Número de rede inválido (88)

Número de rede duplicado (89)

Parâmetro fora dos limites (90)

Acesso negado (91)

Memória insuficiente (92)

Já existe (93)

Caminho, arquivo ou objeto não encontrado (94)

Não é possível notificar o serviço (95)

Não é possível notificar o serviço DNS (96)

Interface não configurável (97)

Nem todas as concessões dhcp poderiam ser liberadas/renovadas (98)

DHCP não habilitado no adaptador (100)

Outros (101 4294967295)

Comentários

Essa é uma chamada de método dependente de instância que se aplica por adaptador. Depois que os servidores DNS estáticos forem especificados para começar a usar o PROTOCOLO DHCP em vez de servidores DNS estáticos, você poderá chamar o método sem fornecer parâmetros "in".

Exemplos

O exemplo Definir ordem de pesquisa do servidor DNS para vários computadores em uma unidade organizacional VBScript na Galeria do TechNet recupera ou define a ordem de pesquisa do Servidor DNS para vários computadores que pertencem a uma unidade organizacional.

O exemplo Modificar a ordem de pesquisa do servidor DNS para um adaptador de rede VBScript configura um adaptador de rede associado a TCP/IP para usar dois servidores DNS.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

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