Calificadores de WMI estándar
A continuación se enumeran los calificadores estándar específicos de WMI.
Amendment
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 de que el proveedor realice primero una llamada a GetObject para validar la ruta 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 no se realicen ninguna de las siguientes acciones:
- 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 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.
Tipo de datos: VT_BSTR
Se aplica a: propiedades, métodos y 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.
Deprecated
Tipo de datos: CIM_BOOLEAN
Se aplica a: propiedades, clases
Indica que otra propiedad ha reemplazado a la propiedad.
Display
Se aplica a: clases, propiedades
UUID de la clase asociada.
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.
Fixed
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 y 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.
Implemented
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.
Locale
Tipo de datos: VT_BSTR
Se aplica a: clases o instancias
Especifica el lenguaje 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.
NamespaceSecuritySDDL
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, consulte Establecimiento de la seguridad del espacio de nombres al crearlo. 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, consulte Establecimiento de descriptores de seguridad de espacio de nombres.
Optional
Tipo de datos: booleano
Se aplica a: parámetros
Indica que un parámetro no es necesario y que tiene un valor predeterminado bien definido.
Privileges
Tipo de datos: matriz de cadenas
Se aplica a: propiedades, métodos
Conjunto de valores usados para informar al cliente de los privilegios 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.
Provider
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 Dynamic.
RequiresEncryption
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, consulte Establecimiento de descriptores de seguridad de espacio de nombres. El calificador se usa en MOF con el comando pragma del preprocesador del espacio de nombres.
Para obtener más información, vea Establecimiento del nivel de seguridad de proceso predeterminado mediante C++ o Establecimiento del 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).
Static
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.
SubType
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
El 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.
Comentarios
Códigos de configuración regional
Un código de configuración regional tiene el formato "MS_<ID de idioma de tres dígitos>". Por ejemplo, la configuración regional en inglés es MS_409. En la siguiente tabla se enumeran los ID de idioma.
| Lenguaje | ID 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 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 de tipo Circle; y ejecuta la implementación de Circle de DrawIt. Sin embargo, si usa el calificador Bypass_GetObject en DrawIt, WMI no llama a GetObject, no detecta que "Shape.Name='MyCircle'" es de tipo Circle 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 |