Método SetGateways de la clase Win32_NetworkAdapterConfiguration

El método de claseSetGatewaysWMI 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

No hay memoria suficiente

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

Observaciones

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
CIMWin32.mof
Archivo DLL
CIMWin32.dll

Consulte también

Clases de hardware del sistema de equipos

Win32_NetworkAdapterConfiguration

Tareas de WMI: Redes

Tareas de WMI: cuentas y dominios

Compatibilidad con IPv6 e IPv4 en WMI