Método EnableStatic de la clase Win32_NetworkAdapterConfiguration
El método de clase WMIEnableStatic habilita el direccionamiento TCP/IP estático para el adaptador de red de destino. Como resultado, DHCP para este adaptador de red está deshabilitado.
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 EnableStatic(
[in] string IPAddress[],
[in] string SubnetMask[]
);
Parámetros
-
IPAddress [in]
-
Enumera todas las direcciones IP estáticas del adaptador de red actual.
Ejemplo: 155.34.22.0.
-
SubnetMask [in]
-
Máscaras de subred que complementan los valores del parámetro IPAddress .
Ejemplo: 255.255.0.0.
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 número 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, no es necesario reiniciar.
-
Finalización correcta, reinicio necesario
-
1
Finalización correcta, reinicio necesario.
-
Método no admitido 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
Se han especificado más de cinco puertas de enlace.
-
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 de 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. Para obtener más información, vea la sección Comentarios.
-
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 o objeto no encontrado
-
94
Ruta de acceso, archivo o 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.
-
2147786788
-
Bloqueo de escritura no habilitado. Para obtener más información, vea INetCfgLock::AcquireWriteLock.
-
Otros
-
101 4294967295
Comentarios
Al usar EnableStatic para cambiar la dirección IP del equipo remoto, mientras se conecta a través de ese adaptador, es probable que pierda la conexión al equipo remoto y reciba un mensaje de error RPC no disponible. (sin embargo, la configuración se cambia). Para evitar este escenario, considere la posibilidad de cambiar la configuración de puerta de enlace o DNS antes de establecer la dirección IP del adaptador.
Cuando se usa EnableStatic para proporcionar a un adaptador una configuración DE IP estática, la función devuelve un "81 - No se puede configurar el servicio DHCP" si el adaptador ya está configurado con una dirección estática. Sin embargo, la función sigue estableciendo correctamente con la nueva operación.
Ejemplos
La dirección IP estática y, a continuación, se une a un ejemplo de código de PowerShell de dominio, en la Galería de TechNet, usa EnableStatic para agregar una dirección IP estática a un equipo local.
En el ejemplo de código Assign a Static IP Address VBScript (Asignar una dirección IP estática VBScript), en la Galería de TechNet, se usa EnableStatic para establecer la dirección IP de un equipo.
En el ejemplo de VBScript siguiente se muestra cómo deshabilitar el uso de DHCP en una instancia de Win32_NetworkAdapterConfiguration. En este caso, se especifica el adaptador con un índice de 0. El índice correcto debe seleccionarse de Win32_NetworkAdapter instancias para otras interfaces.
Nota
Este script solo se aplica a los sistemas basados en NT Cambie las variables de ipaddr y subred siguientes a los valores que desea aplicar al adaptador.
Set Adapter = GetObject("winmgmts:Win32_NetworkAdapterConfiguration=1")
ipaddr = Array("1.1.1.1")
subnet = Array("255.255.255.0")
RetVal = Adapter.EnableStatic(ipaddr,subnet)
if RetVal = 0 then
WScript.Echo "DHCP disabled, using static IP address"
else
WScript.Echo "DHCP disable failed"
end if
En el ejemplo de Perl siguiente se muestra cómo deshabilitar el uso de DHCP en una instancia de Win32_NetworkAdapterConfiguration. En este caso, se especifica el adaptador con un índice de 0. El índice correcto debe seleccionarse de Win32_NetworkAdapter instancias para otras interfaces.
Nota
Este script solo se aplica a los sistemas basados en NT Cambie las variables de ipaddr y subred siguientes a los valores que desea aplicar al adaptador.
use strict;
use Win32::OLE;
my ($Adapter, @ipaddr, @subnet, $RetVal);
eval { $Adapter =
Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2:Win32_NetworkAdapterConfiguration.Index=\"0\""); };
unless ($@)
{
push @ipaddr, "192.168.144.107";
push @subnet, "255.255.255.0";
$RetVal = $Adapter->EnableStatic(\@ipaddr, \@subnet);
if ($RetVal == 0)
{
print "\nDHCP disabled, using static IP address\n";
}
else
{
print "\nDHCP disable failed\n";
}
}
else
{
print STDERR "\n", Win32::OLE->LastError, "\n";
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de