Método SetIPConnectionMetric de la clase Win32_NetworkAdapterConfiguration
El método SetIPConnectionMetric se usa para establecer la métrica de enrutamiento asociada a este adaptador enlazado a IP.
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 SetIPConnectionMetric(
[in] uint32 IPConnectionMetric
);
Parámetros
-
IPConnectionMetric [in]
-
Indica el costo de usar las rutas configuradas para este adaptador enlazado a IP. El valor se pondera para esas rutas en la tabla de enrutamiento IP. Si hay varias rutas a un destino en la tabla de enrutamiento, se usa la ruta con la métrica más baja. El intervalo de valores válidos es de 1 a 9999. El valor predeterminado es 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 de 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, no es necesario reiniciar.
-
Finalización correcta, reinicio necesario
-
1
Finalización correcta, se requiere reiniciar.
-
No se admite el método en esta plataforma
-
64
No se admite el método en esta plataforma.
-
Error desconocido
-
65
Error desconocido.
-
Máscara de subred no válida
-
66
Máscara de subred no válida.
-
Error al procesar una instancia devuelta
-
67
Error al procesar una instancia de que se devolvió.
-
Parámetro de entrada no válido
-
68
El parámetro de entrada no es válido.
-
Más de 5 puertas de enlace especificadas
-
69
Más de cinco puertas de enlace especificadas.
-
Dirección IP no válida
-
70
Dirección IP no válida.
-
Dirección IP de puerta de enlace no válida
-
71
Dirección IP de puerta de enlace no válida.
-
Error al acceder al Registro para obtener la información solicitada.
-
72
Error al acceder al registro para obtener la información solicitada.
-
Nombre de dominio no válido
-
73
Nombre de dominio no válido.
-
Nombre de host no válido
-
74
Nombre de host no válido.
-
No se ha definido ningún servidor WINS principal o secundario
-
75
No se ha definido ningún servidor WINS principal o secundario.
-
Archivo no válido
-
76
Archivo no válido.
-
Ruta de acceso del sistema no válida
-
77
Ruta de acceso del sistema no válida.
-
Error de copia de archivos
-
78
Error en la copia de archivos.
-
Parámetro de seguridad no válido
-
79
Parámetro de seguridad no válido.
-
No se puede configurar el servicio TCP/IP
-
80
No se puede configurar el servicio TCP/IP.
-
No se puede configurar el servicio DHCP
-
81
No se puede configurar el servicio DHCP.
-
No se puede renovar la concesión dhcp
-
82
No se puede renovar la concesión dhcp.
-
No se puede liberar la concesión dhcp
-
83
No se puede liberar la concesión dhcp.
-
Ip no habilitada en el adaptador
-
84
Ip no habilitada en el adaptador.
-
IPX no habilitado en el adaptador
-
85
IPX no está habilitado en el adaptador.
-
Error de límites de número de red o marco
-
86
Error de límites de número de red o marco.
-
Tipo de marco no válido
-
87
Tipo de marco no válido.
-
Número de red no válido
-
88
Número de red no válido.
-
Número de red duplicado
-
89
Número de red duplicado.
-
Parámetro fuera de los límites
-
90
Parámetro fuera de los límites.
-
Acceso denegado
-
91
Acceso denegado.
-
Memoria insuficiente
-
92
Memoria insuficiente
-
Ya existe
-
93
Ya existe.
-
Ruta de acceso, archivo u objeto no encontrado
-
94
Ruta de acceso, archivo u objeto no encontrado.
-
No se puede notificar al servicio
-
95
No se puede notificar al servicio.
-
No se puede notificar al servicio DNS
-
96
No se puede notificar al servicio DNS.
-
Interfaz no configurable
-
97
Interfaz no configurable.
-
No todas las concesiones DHCP se podrían liberar o renovar
-
98
No todas las concesiones DHCP se podrían liberar o renovar.
-
DHCP no habilitado en el adaptador
-
100
DHCP no habilitado en el adaptador.
-
Otros
-
101 4294967295
Ejemplos
El ejemplo Modify the IP Connection Metric for a Network Adapter VBScript (Modificar la métrica de conexión IP para un adaptador de red) establece la métrica de conexión IP para un adaptador de red en 100.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista, Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008, Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|