Calificadores de WMI estándar

A continuación se enumeran los calificadores estándar específicos de WMI.

Enmienda

Tipo de datos: booleano

Se aplica a: clases

Indica que una clase contiene calificadores modificados localizados. El valor predeterminado es TRUE.

La clase asociada se puede traducir. Para acceder a la versión traducida, use el identificador de configuración regional para construir un nombre de espacio de nombres.

Bypass_GetObject

Tipo de datos: booleano

Se aplica a: métodos

Indica que la llamada al método debe pasarse directamente a la llamada ExecMethodAsync del proveedor en lugar del proveedor que primero realiza una llamada a GetObject para validar la ruta de acceso del objeto. El valor predeterminado es FALSE. El uso de Bypass_GetObject puede mejorar significativamente el rendimiento.

Antes de usar Bypass_GetObject, asegúrese de que ninguna de las siguientes acciones se realice:

  • Derive una clase de la clase .
  • Invalide el método que tiene el calificador Bypass_GetObject .

Si no se siguen estas precauciones, se puede invocar la implementación del método de la clase primaria en lugar de la clase secundaria. Para obtener más información, consulte Uso del calificador de Bypass_GetObject.

CIM_Key

Tipo de datos: CIM_BOOLEAN

Se aplica a: propiedades

Indica que la propiedad asociada es una propiedad de clave en CIM, pero no en WMI.

CIMType

Tipo de datos: VT_BSTR

Se aplica a: propiedades, métodos, parámetros

Contiene texto que describe el tipo de una propiedad.

ClassContext

Tipo de datos: VT_BSTR

Se aplica a: clases

Indica que una clase tiene instancias asociadas con más información proporcionada dinámicamente por un proveedor.

Obsoleto

Tipo de datos: CIM_BOOLEAN

Se aplica a: propiedades, clases

Indica que otra propiedad ha reemplazado a la propiedad .

Monitor

Se aplica a: clases, propiedades

UUID de la clase asociada.

Dinámica

Tipo de datos: booleano

Se aplica a: clases, propiedades

Indica una clase cuyas instancias se crean dinámicamente. El valor de este calificador debe establecerse en TRUE.

DynProps

Tipo de datos: booleano

Se aplica a: clases, instancias

Indica que una instancia contiene valores proporcionados por proveedores de propiedades dinámicas. El valor predeterminado es TRUE.

Debe especificar este calificador en dicha instancia. Solo se permite el valor TRUE .

Fijo

Tipo de datos: CIM_BOOLEAN

Se aplica a: instancias

Indica que el valor de esta propiedad no puede cambiar durante la vigencia de la instancia.

ID

Tipo de datos: VT_I4

Se aplica a: propiedades, parámetros

Identifica y secuencia de forma única una propiedad o un parámetro de método cuando las instrucciones MOF se generan automáticamente.

Este calificador solo es necesario para los parámetros de método. Al crear parámetros para un método, los diseñadores de clases deben comenzar por Id(0) para el primer parámetro y usar cada entero sucesivo para cada parámetro sucesivo. Si los calificadores de identificador se omiten involuntariamente, el compilador MOF genera automáticamente calificadores de identificador .

Implementado

Tipo de datos: booleano

Se aplica a: métodos

Indica que un método tiene una implementación proporcionada por un proveedor.

InstanceContext

Tipo de datos: VT_BSTR

Se aplica a: instancias

Indica que una instancia contiene valores proporcionados por un proveedor de propiedades dinámicas.

El valor se pasa al proveedor de propiedades como argumento al método IWbemPropertyProvider::GetProperty .

Configuración regional

Tipo de datos: VT_BSTR

Se aplica a: clases o instancias

Especifica el idioma de origen de una clase o instancia. Para obtener más información sobre los valores de configuración regional, vea Códigos de configuración regional.

Espacio de nombresSecuritySDDL

Tipo de datos: matriz de cadenas

Se aplica a: instancias de espacio de nombres

Especifica un descriptor de seguridad para el espacio de nombres en formato SDDL . Para obtener más información, vea Establecer la seguridad del espacio de nombres cuando se crea el espacio de nombres. WMI procesa la cadena SDDL para establecer la seguridad del espacio de nombres, pero no se almacena como una cadena. Si no se especifica ningún descriptor de seguridad, se usa la seguridad predeterminada. Para obtener más información, vea Establecer descriptores de seguridad de espacio de nombres.

Opcional

Tipo de datos: booleano

Se aplica a: parámetros

Indica que un parámetro no es necesario y que tiene un valor predeterminado bien comportado.

Privilegios

Tipo de datos: matriz de cadenas

Se aplica a: propiedades, métodos

Conjunto de valores usados para informar al cliente de qué privilegios son necesarios para crear instancias, rellenar propiedades o realizar métodos. El valor predeterminado es FALSE.

PropertyContext

Tipo de datos: VT_BSTR

Se aplica a: propiedades

Indica que una propiedad de instancia contiene valores proporcionados por proveedores de propiedades dinámicas.

Debe especificar este calificador en dicha propiedad. El valor se pasa al proveedor de propiedades como argumento a IWbemPropertyProvider::GetProperty.

Proveedor

Tipo de datos: VT_BSTR

Se aplica a: clases

El valor de este calificador es el nombre del proveedor dinámico que proporciona instancias de clase y actualiza los datos de instancia. Este nombre debe registrarse con WMI mediante la creación de una instancia de la clase __Win32Provider con la propiedad Name que contiene este nombre. Cuando se especifica este calificador en una clase cuyas instancias se proporcionan dinámicamente, también se debe especificar el calificador dinámico .

RequireEncryption

Tipo de datos: booleano

Se aplica a: instancias de espacio de nombres

Si se establece en TRUE, RequireEncryption marca un espacio de nombres para que las aplicaciones cliente y los scripts se conecten con la autenticación cifrada. El nivel de autenticación debe establecerse en RPC_C_AUTHN_LEVEL_PKT_PRIVACY en C++. En scripting o Visual Basic, el nivel de autenticación debe establecerse en WbemAuthenticationLevelPktPrivacy. Para obtener más información, vea Establecer descriptores de seguridad de espacio de nombres. El calificador se usa en MOF con el comando pragma namespace preprocessor.

Para obtener más información, vea Establecer el nivel de seguridad de proceso predeterminado mediante C++ o Establecer el nivel de seguridad de proceso predeterminado mediante VBScript. Los niveles de autenticación de scripting se definen en WbemAuthenticationLevelEnum.

Singleton

Tipo de datos: booleano

Se aplica a: clases

Designa una clase que solo puede tener una instancia y que no contiene propiedades clave.

Solo se permite el valor TRUE (valor predeterminado).

Estática

Tipo de datos: booleano

Se aplica a: métodos

Indica si se puede llamar a un método mediante la definición de clase o sus instancias.

No se puede invocar el método desde una instancia de .

Subtipo

Tipo de datos: VT_BSTR

Se aplica a: propiedades

Indica que una propiedad de tipo CIM_DATETIME representa un intervalo de tiempo en lugar de un tiempo específico.

Para identificar la propiedad como un intervalo, el valor de este calificador debe ser "interval". Todos los demás valores de este calificador están reservados para uso futuro.

UUID

Tipo de datos: cadena

Se aplica a: clases

Identificador único universal aplicado a la clase .

ClassVersion

Tipo de datos: cadena

Se aplica a: clases

Número de versión del objeto de clase. El valor predeterminado es NULL. El número de versión se incrementa cuando se realizan cambios en la clase .

WritePrivileges

Tipo de datos: matriz de cadenas

Se aplica a: propiedades

Conjunto de valores que indican qué privilegios del sistema deben estar disponibles y habilitados para una operación de escritura correcta.

Observaciones

Códigos de configuración regional

Un código de configuración regional tiene el formato "MS_< Id. de idioma> de dígitos dethree". Por ejemplo, la configuración regional en inglés es MS_409. En la tabla siguiente se enumeran los identificadores de idioma.

Idioma Identificador de idioma (hexadecimal)
Árabe 401
Portugués (Brasil) 416
Chino (simplificado) 804
Chino (tradicional) 404
Checo 405
Danés 406
Neerlandés 413
Inglés (predeterminado) 409
Finés 40b
Francés 40c
Alemán 407
Griego 408
Hebreo 40d
Húngaro 40e
Italiano 410
Japonés 411
Coreano 412
Noruego 414
Polaco 415
Portugués (Portugal) 816
Ruso 419
Español c0a
Sueco 41D
Turco 41f

Uso del calificador de Bypass_GetObject

El uso del calificador Bypass_GetObject en un método puede producir resultados confusos.

En el ejemplo siguiente se definen las clases Shape y Circle . Tenga en cuenta que la clase Circle se deriva de la clase Shape .

class Shape
{
   string Name;
   uint32 DrawIt();  // - draws an irregular geometric shape
};

class Circle : Shape
{
   uint32 DrawIt();  // - draws a circle
};

La siguiente llamada a ExecMethod usa un objeto Circle denominado "MyCircle" para dibujar un círculo.

ExecMethod("Shape.Name='MyCircle'","DrawIt");

En el escenario anterior, WMI llama a GetObject; descubre que "Shape.Name='MyCircle'" es un círculo; y ejecuta la implementación circle de DrawIt. Sin embargo, si usa el calificador de Bypass_GetObject en DrawIt, WMI no llama a GetObject, no detecta que "Shape.Name='MyCircle'" es un círculo y ejecuta la implementación shape de DrawIt en lugar de la implementación circle de DrawIt.

La siguiente llamada a ExecMethod siempre invoca la implementación correcta de DrawIt.

ExecMethod("Circle.Name='MyCircle'","DrawIt");

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista
Servidor mínimo compatible
Windows Server 2008

Consulte también

Establecer descriptores de seguridad de espacio de nombres

Calificadores WMI

Agregar un calificador