Método SetGateways de la clase Win32_NetworkAdapterConfiguration
El método de clase WMISetGateways especifica una lista de puertas de enlace para enrutar paquetes a una subred diferente de la subred a la que está conectado el adaptador de red.
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 SetGateways(
[in] string DefaultIPGateway[],
[in, optional] uint16 GatewayCostMetric[]
);
Parámetros
-
DefaultIPGateway [in]
-
Lista de direcciones IP a puertas de enlace en las que se enrutan los paquetes de red.
-
GatewayCostMetric [in, opcional]
-
Asigna un valor que oscila entre 1 y 9999, que se usa para calcular las rutas más rápidas y confiables. Los valores de este parámetro corresponden a los valores del parámetro DefaultIPGateway . El valor predeterminado de una puerta de enlace es 1.
Valor devuelto
Devuelve un valor de 0 (cero) para una finalización correcta cuando no se requiere un reinicio, 1 (uno) para una finalización correcta cuando se requiere un reinicio y cualquier otro valor 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 necesidad de reinicio
-
0
-
Finalización correcta, reinicio necesario
-
1
-
Método no admitido en esta plataforma
-
64
No se admite el método cuando la NIC está en modo DHCP.
-
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
-
No se ha definido ningún servidor WINS principal o secundario
-
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
Este método solo funciona cuando la tarjeta de interfaz de red (NIC) está en modo IP estático.
Para borrar la puerta de enlace, establezca la puerta de enlace en la misma dirección IP que use en EnableStatic.
Ejemplos
El ejemplo Modify the Gateways for a Network Adapter VBScript configura dos puertas de enlace para un adaptador de red.
El ejemplo Asignar una dirección IP estática VBScript establece la dirección IP y la puerta de enlace de un equipo.
La dirección IP estática y, a continuación, se une a un ejemplo de PowerShell de dominio ayuda a volver a generar máquinas.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|