Método SetDNSServerSearchOrder de la clase Win32_NetworkAdapterConfiguration
El método de clase WMISetDNSServerSearchOrder usa una matriz de elementos de cadena para establecer el orden de búsqueda del servidor.
En este tema se usa la sintaxis de Managed Object Format (MOF). Para obtener más información sobre el uso de este método, vea Llamar a un método.
Sintaxis
uint32 SetDNSServerSearchOrder(
[in] string DNSServerSearchOrder[]
);
Parámetros
-
DNSServerSearchOrder [in]
-
Lista de direcciones IP del servidor para consultar servidores DNS.
Ejemplo: 130.215.24.1 o 157.54.164.1
Valor devuelto
Devuelve un valor de 0 (cero) para una finalización correcta cuando no se requiere ningún reinicio, 1 (uno) para una finalización correcta cuando se requiere un reinicio y un número diferente si se produce un error. Para obtener más información sobre los códigos de error, vea Constantes de error WMI o WbemErrorEnum. Para obtener valores HRESULT generales, consulte Códigos de error del sistema.
-
Finalización correcta, sin reinicio necesario (0)
-
Finalización correcta, reinicio necesario (1)
-
Método no admitido en esta plataforma (64)
-
Error desconocido (65)
-
Máscara de subred no válida (66)
-
Error al procesar una instancia devuelta (67)
-
Parámetro de entrada no válido (68)
-
Más de 5 puertas de enlace especificadas (69)
-
Dirección IP no válida (70)
-
Dirección IP de puerta de enlace no válida (71)
-
Error al acceder al Registro para obtener la información solicitada (72)
-
Nombre de dominio no válido (73)
-
Nombre de host no válido (74)
-
Ningún servidor WINS principal o secundario definido (75)
-
Archivo no válido (76)
-
Ruta de acceso del sistema no válida (77)
-
Error de copia de archivos (78)
-
Parámetro de seguridad no válido (79)
-
No se puede configurar el servicio TCP/IP (80)
-
No se puede configurar el servicio DHCP (81)
-
No se puede renovar la concesión DHCP (82)
-
No se puede liberar la concesión DHCP (83)
-
Ip no habilitada en el adaptador (84)
-
IPX no habilitado en el adaptador (85)
-
Error de límites de número de red o marco (86)
-
Tipo de marco no válido (87)
-
Número de red no válido (88)
-
Número de red duplicado (89)
-
Parámetro fuera de los límites (90)
-
Acceso denegado (91)
-
Memoria insuficiente (92)
-
Ya existe (93)
-
Ruta de acceso, archivo u objeto no encontrado (94)
-
No se puede notificar al servicio (95)
-
No se puede notificar al servicio DNS (96)
-
Interfaz no configurable (97)
-
No todas las concesiones DHCP se podrían liberar o renovar (98)
-
DHCP no habilitado en el adaptador (100)
-
Otros (101 4294967295)
Comentarios
Se trata de una llamada de método dependiente de la instancia que se aplica por adaptador. Después de especificar los servidores DNS estáticos para empezar a usar el Protocolo de configuración dinámica de host (DHCP) en lugar de los servidores DNS estáticos, puede llamar al método sin proporcionar parámetros "in".
Ejemplos
El ejemplo Set DNS Server Search Order for Multiple Computers in an Organizational Unit VBScript on TechNet Gallery recupera o establece el orden de búsqueda del servidor DNS para varios equipos que pertenecen a una unidad organizativa.
El ejemplo Modify the DNS Server Search Order for a Network Adapter VBScript configura un adaptador de red enlazado a TCP/IP para usar dos servidores DNS.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|