Regreso a la pantalla de contenido

Actualización de la configuración: Guía del usuario de proveedores WMI y CDM para adaptadores de red Intel® PRO

Visión general
Cambiar la configuración de un adaptador, equipo o VLAN
Crear un equipo nuevo (vacío)
Agregar un adaptador a un equipo
Eliminar un adaptador de un equipo
Eliminar un equipo
Cambiar el modo de un equipo
Cambiar la prioridad de un adaptador dentro de un equipo
Desinstalar un adaptador
Crear una VLAN
Cambiar los atributos de una VLAN
Eliminar una VLAN
Actualizar el agente de inicio


Visión general

En la mayoría de los casos, para actualizar la configuración, la aplicación cliente deberá obtener un controlador de sesión de la clase IANet_NetService y guardar esta identificación en un objeto de contexto IWbemContext. Los cambios de la configuración ocurrirán solamente cuando se llama el método Apply en IANet_NetService. Este requisito tiene algunas excepciones:

Para algunas operaciones, se puede utilizar el calificador PreCheck en el contexto para verificar si es que se permitió un operación. Esto permite la utilización de una interfaz de usuario a fin de inhabilitar ciertos controles o elementos del menú si fuera necesario.

Principio


Cambiar la configuración del adaptador, equipo o VLAN

El cambio de la configuración de un adaptador, equipo o VLAN:

Para cambiar la configuración de un adaptador, VLAN o equipo, el cliente deberá obtener primero la ruta del objeto de la configuración que se va a cambiar. La mejor manera de lograrlo es enumerar las configuraciones en el objeto y guardar el atributo __PATH de la configuración (vea lo indicado anteriormente).

Para el cliente la forma más fácil de actualizar una configuración es:

  1. Obtener una instancia del objeto de configuración del WMI.
  2. Modificar el atributo CurrentValue (usando IWbemClassObject::Put()).
  3. Llamar a IWbemServices::PutInstance() para pasar la instancia modificada al proveedor WMI. Deberá llamarse a PutInstance con el indicador WBEM_FLAG_UPDATE_ONLY.

El Proveedor WMI validará el CurrentValue y devolverá WBEM_E_FAIL si es que falló la validación. La razón exacta de la falla será devuelta en el atributo Description del objeto IANet_ExtendedStatus.

El establecimiento de descripciones específicas de los valores incluye:

La última descripción es devuelta cuando el valor actual de IANet_SettingEnum, IANet_SettingSlider o IANet_SettingMultiSelection no es uno de los valores permitidos.

El único atributo de una configuración que puede cambiar el cliente es CurrentValue. El proveedor WMI ignorará los cambios que se hicieron a cualesquiera de los otros valores.

No hay métodos compatibles con esta clase. Para cambiar una configuración, modifique la propiedad CurrentValue y luego llame a PutInstance.

Principio


Crear un equipo nuevo (vacío)

La creación de un equipo nuevo:

A fin de crear un equipo nuevo, se debe crear una instancia de IANet_TeamOfAdapters (es decir, use IWbemServices::GetObject() para obtener un objeto de clase para IANet_TeamOfAdapters y luego use IWbemServices::SpawnInstance() para crear una instancia de este objeto).

Luego, use IWbemClassObject::Put para fijar el atributo TeamMode en la instancia que será el tipo de equipo deseado (por ejemplo, AFT). Finalmente, llame a IWbemServices::PutInstance() para crear el equipo, pasando el indicador WBEM_FLAG_CREATE_ONLY.

La ruta al objeto del nuevo equipo se guarda en el IWbemCallResultObject, el cual se le transfiere de regreso en cuanto se completa la llamada. El método IWbemCallResult::GetResultString va a obtener la nueva ruta al objeto.

Si fallara esta acción, el cliente debería verificar IANet_ExtendedStatus para obtener las razones de la falla.

Las clases de IANet_EthernetAdapter virtual e IANet_IPProtocolEndpoint para el equipo están disponibles hasta después de la llamada a Apply. Se puede acceder a la configuración del equipo usando el objeto IANet_Configuration asociado con el IANet_TeamOfAdapters nuevo.

Principio


Agregar un adaptador a un equipo

La adición de un adaptador a un equipo

Para crear un equipo nuevo, se debe crear una instancia de IANet_TeamedMemberAdapter (es decir, use IWbemServices::GetObject() para obtener un objeto de clase para IANet_TeamedMemberAdapter y luego use IWbemServices::SpawnInstance() para crear una instancia de este objeto).

Se deben establecer los atributos siguientes en el objeto utilizando IWbemClassObject::Put():

También se puede fijar la prioridad del adaptador en el equipo. Finalmente, llame a IWbemServices::PutInstance() para agregar el adaptador, pasando el indicador WBEM_FLAG_CREATE_ONLY. Si esta acción falla, busque el código de error en IANet_ExtendedStatus.

Principio


Eliminar un adaptador de un equipo existente

La eliminación de un adaptador de un equipo existente:

Para eliminar un adaptador de un equipo, elimine la instancia de IANet_TeamedMemberAdapter que asocia el adaptador al equipo usando IWbemServices::DeleteInstance(). Si esta acción falla, busque el código de error en IANet_ExtendedStatus.

Principio


Eliminar un equipo

La eliminación de un equipo:

Para eliminar un equipo, elimine la instancia IANet_TeamOfAdapters usando IWbemServices::DeleteInstance(). Si esta acción falla, busque el código de error en IANet_ExtendedStatus.

Principio


Cambiar el modo de un equipo

El cambio del modo de un equipo:

Para cambiar el modo de un equipo, obtenga la instancia de IANet_TeamOfAdapters para el equipo (por ejemplo, use IWbemServices::GetObject utilizando la ruta de objeto del equipo). Luego, use IWbemClassObject::Put para cambiar el atributo TeamMode del equipo. Finalmente, llame a IWbemClassObject:: PutInstance para indicar al proveedor WMI que actualice el modo del equipo, pasando el indicador WBEM_FLAG_UPDATE_ONLY. Si esta acción falla, busque el código de error en IANet_ExtendedStatus.

Principio


Cambiar la prioridad de un adaptador en un equipo

El cambio de la prioridad de un adaptador en un equipo:

Para cambiar la prioridad de un adaptador, el cliente deberá obtener primero la instancia del adaptador de IANet_TeamedMemberAdapter. (por ejemplo. use IWbemServices::GetObject utilizando la ruta del objeto). Luego, el cliente puede usar IWbemClassObject::Put para cambiar el atributo AdapterFunction del adaptador. Finalmente, el cliente deberá llamar a IWbemClassObject:: PutInstance para indicar al proveedor WMI que actualice la prioridad del adaptador. Si esta acción falla, busque el código de error en IANet_ExtendedStatus.

Principio


Desinstalar un adaptador

La desinstalación de un adaptador:

Para desinstalar un adaptador, llame a IWbemServices::DeleteInstance, pasando la ruta del objeto del adaptador que se va a desinstalar.

Principio


Crear una VLAN

La creación de una VLAN:

Para crear una VLAN, llame el método CreateVLAN en el IANet_802dot1QVLANService para el adaptador al que se va agregar la VLAN. Se deben pasar los argumentos siguientes al método:

La función devolverá la ruta del objeto de la VLAN recién creada en el parámetro Out de VLANpath. Si esta acción falla, busque el código de error en IANet_ExtendedStatus.

Principio


Cambiar los atributos de una VLAN

El cambio de atributos de una VLAN:

El cliente puede cambiar los atributos VLANNumber y VLANNAme de una VLAN. Para cambiar la prioridad de un adaptador, obtenga primero una instancia de IANet_VLAN para el adaptador (por ejemplo, use IWbemServices::GetObject utilizando la ruta del objeto).

Luego, cambie VLANNumber o VLANName a los valores deseados. Finalmente, llame a IWbemClassObject:: PutInstance para indicar al proveedor WMI que actualice el modo del equipo, pasando el indicador WBEM_FLAG_UPDATE_ONLY. Si esta acción falla, busque el código de error en IANet_ExtendedStatus.

Principio


Eliminar una VLAN

La eliminación de una VLAN:

Para eliminar una VLAN llame a IWbemServices::DeleteInstance, pasando la ruta del objeto de VLAN que se va a eliminar.

Principio


Actualizar el agente de inicio

La actualización del agente de inicio:

El cliente puede actualizar la imagen del agente de inicio usando llamadas de método. Para leer o escribir la imagen flash, obtenga primero una instancia de IANet_BootAgent para el adaptador (por ejemplo, use IWbemServices::GetObject utilizando la ruta del objeto).

Luego, ejecute ReadFlash() para leer la imagen flash de inicio de ROM existente o ProgramFlash() para actualizar la imagen flash de inicio de ROM. Si esta acción falla, busque el código de error en IANet_ExtendedStatus.

 
Tarea Métodos WMI Resultado Comentarios
Actualizar o insertar una imagen de inicio ROM para el adaptador uint32 ProgramFlash(
                           [IN,
          ValueMap {"0","1"} ,
          Values {"Check Version", "Write Flash"}: Amended
                           ]
                           uint32 Action,
                           [IN]
                           uint8 NewFlashData[],
                           [OUT]
                           string strErrorMessage
                           );
Si se especificó la acción "Check Version", el método devolverá un mensaje de advertencia si es que la imagen de inicio de ROM que se actualizaría como en un NewFlashData[] es más antigua que la versión que ya está presente en la NIC.

Si se especificó la acción "Write", se actualiza la FLASH ROM en la NIC con NewFlashData[].

Este método se usa para actualizar la flash ROM de la NIC. La NIC dejará de comunicarse con la red mientras se actualiza la memoria flash.
Leer la imagen de inicio de ROM uint32 ReadFlash( [OUT] uint8
FlashData[] );
FlashData[] incluye la imagen flash ROM de la NIC. Este método lee la flash ROM de la NIC, que puede guardarse en un archivo.


Sírvase leer todas las restricciones y renuncias de responsabilidad.


Regreso a la pantalla de contenido   Principio