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 |
|
| DLL |
|