Método SetWINSServer de la clase Win32_NetworkAdapterConfiguration

El método de clase WMISetWINSServer establece los servidores principal y secundario del Servicio de nomenclatura de Internet de Windows (WINS) en este adaptador de red enlazado a TCP/IP. Este método se aplica independientemente del 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 SetWINSServer(
  [in] string WINSPrimaryServer,
  [in] string WINSSecondaryServer
);

Parámetros

WINSPrimaryServer [in]

Dirección IP del servidor WINS principal.

Nota

Compruebe siempre la validez de esta dirección IP cuando procede de un origen desconocido o de un origen en el que no confíe.

WINSSecondaryServer [in]

Dirección IP del servidor WINS secundario.

Nota

Compruebe siempre la validez de esta dirección IP cuando procede de un origen desconocido o de un origen en el que no confíe.

Valor devuelto

Devuelve un valor entero de 0 (cero) al completarse correctamente y cualquier otro número para indicar 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.

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.

Otros

101 4294967295

Comentarios

Si WINSPrimaryServer y WINSSecondaryServer se establecen en "" (una cadena vacía), los servidores WINS explícitos vuelven a DHCP.

Ejemplos

Asignar una dirección IP recuperada de una base de datos El ejemplo de código VBScript busca un equipo en una base de datos y asigna a ese equipo la dirección IP especificada.

El siguiente ejemplo de código VBScript establece el servidor WINS principal y secundario para un adaptador de red enlazado a TCP/IP.

On Error Resume Next 
 
strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
 
Set colNetCards = objWMIService.ExecQuery _ 
    ("Select * From Win32_NetworkAdapterConfiguration Where IPEnabled = True") 
 
For Each objNetCard in colNetCards 
    strPrimaryServer = "192.168.1.100" 
    strSecondaryServer = "192.168.1.200" 
    objNetCard.SetWINSServer strPrimaryServer, strSecondaryServer 
Next 

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