Regreso a la pantalla de contenido

Espacio de nombre y contexto: Guía del usuario de proveedores WMI y CDM para adaptadores de red Intel® PRO


Las clases CIM residen en un espacio de nombre. El espacio de nombre estándar de Microsoft* se llama root/cimv2 y está basado en CIM v2.2 o root/default. Las clases de proveedores WMI y CDM puede agregarse a este espacio de nombre. Los proveedores se basan en CIM v2.5. Debido a eso y a diferencias en las claves de los objetos, las clases de proveedor están ubicadas en un espacio de nombre separado, root/IntelNCS.

Contexto WBEM

Los objetos de contexto proporcionan información adicional a los proveedores, misma que no puede pasarse a un método WMI API como un parámetro. Para registrar calificadores de contexto, use el IWbemContext para registrar los calificadores de contexto. El puntero de interfaz del objeto de contexto se pasa como el último parámetro de un método IWbemServices.

La tabla siguiente contiene los calificadores de contexto (valores nombrados) utilizado por el Proveedor. La mayoría de los calificadores, como SessionHandle, se utilizan solamente junto con áreas funcionales específicas de los proveedores, mientras que LocaleID, MachineName y ApplicationName pueden establecerse para todas las llamadas de IWbemServices.

Si no se pasa algún contexto a los proveedores, utilizarán la LocaleId que se pasó en la llamada Initialize a los proveedores. Cualquier lectura de un contexto que se efectuó leerá la unidad de configuración actual hasta que se ejecute una operación de escritura. Las lecturas subsecuentes mostrarán el sistema tal como estaría después de una escritura satisfactoria. Se puede utilizar un contexto NULO para todas las lecturas.

 
Calificador de contexto Tipo de variante Descripción
SessionHandle VT_BSTR Identifica la copia de la aplicación de las clases de red de IANet. La aplicación no puede efectuar ningún cambio a las clases o a sus atributos sin establecer primero un identificador de sesión. Consulte la sección correspondiente a la clase IANet_NetService para ver la forma en la que se establece y se utiliza un identificador de sesión. Este calificador no es necesario si la aplicación va a leer solamente datos de las clases. El identificador de sesión permite que el software NCS gestione simultáneamente varios accesos a la configuración, impidiendo así que un usuario pueda bloquear a todas las demás. Cada sesión cuenta con un caché separado para guardar cualquier cambio que se haya efectuado. Si hay varios usuarios haciendo cambios simultáneamente, entonces el primer usuario que aplique sus cambios será el que lo logre. Se invalidarán todas las otras memorias caché de los usuarios.
LocaleID VT_BSTR El identificador de Microsoft para una configuración regional. Es necesario si es que la aplicación necesita cadenas de texto localizadas de los proveedores. Todos los mensajes y advertencias de error estarán en inglés, a menos que se utilice el LocaleID necesario.
ApplicationName VT_BSTR El nombre de la aplicación que hizo la llamada. Esto es necesario para el registro.
MachineName VT_BSTR El nombre de la máquina que se conecta a los proveedores. Esto es necesario para el registro.
PreCheck VT_BOOL Este valor booleano se utiliza para indicar a los proveedores que el cliente está intentando verificar que una estación se ha permitido antes de llevar a cabo la operación. Por ejemplo, agregar un adaptador al equipo.

Valores:

  • TRUE = El proveedor no ejecutará la operación, pero devolverá un código de error y un estado ampliado si no se permitió la operación.
  • FALSE = El proveedor va a ejecutar la operación.

Si falta este calificador, tendría el mismo efecto que si el atributo fuera FALSE.

WarningErrorCode VT_I4 Algunas operaciones podrían requerir del envío de advertencias al usuario (por ejemplo, en algunas circunstancias, agregar un adaptador a un equipo podría hacer necesario que el equipo se vuelva a cargar). WMI no proporciona un mecanismo para este efecto. Si está presente este calificador y no es cero, el Proveedor va a devolver E_FAIL si es que la operación fue satisfactoria, pero hubo una advertencia asociada. El cliente deberá utilizar el estado extendido para recibir el texto de la advertencia.


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


Regreso a la pantalla de contenido   Principio