Calificadores de propiedad WMI

En la tabla siguiente se enumeran los calificadores de propiedad MOF obligatorios y opcionales que se pueden usar para definir elementos en un bloque de eventos o datos WMI.

A continuación se muestran calificadores MOF estándar: key, read, write, ValueMap y Values. Para obtener más información sobre estos y otros calificadores MOF estándar, vea Tipos de datos MOF.

Calificador: Descripción

key

Indica que el elemento de datos es una propiedad clave que identifica de forma única cada instancia de la clase . Solo se puede declarar una clave la propiedad InstanceName.

read

Indica que un cliente WMI puede leer el elemento de datos.

write

Indica que un cliente WMI puede establecer el elemento de datos.

Bits

Especifica las posiciones de bits de los valores de cadena correspondientes que se especifican en BitValues.

BitValues

Especifica una lista de valores de cadena (nombres de marca) que representan los bits establecidos en el elemento de datos. La posición de bits de una marca se define mediante la posición correspondiente especificada en BitMap.

DefineValues

Especifica una lista enumerada que el conjunto de herramientas WMI compila en una lista correspondiente de instrucciones #define.

DisplayInHex

Especifica que cualquier cliente WMI que muestre el valor de propiedad debe hacerlo en hexadecimal.

DisplayName("string")

Especifica un subtítulo que un cliente WMI puede usar para mostrarse como nombre de propiedad.

MaxLen(uint)

Para las propiedades de cadena, MaxLen especifica la longitud máxima de la cadena en caracteres. El valor uint puede ser cualquier entero de 32 bits sin signo. Si se omite MaxLen, o uint es cero, la longitud de la cadena es ilimitada.

Valores

Especifica una lista de valores posibles para este elemento de datos. Si el elemento de datos es una enumeración, ValueMap contiene el valor de índice que corresponde al valor de enumeración especificado en Valores.

ValueMap

Especifica los valores enteros de los valores de cadena correspondientes en Valores.

WmiDataId(data-item-ID)

(Obligatorio) Identifica un elemento de datos dentro de un bloque de datos. Los identificadores de elemento de datos deben asignarse a todos los elementos de un bloque, excepto los elementos necesarios InstanceName y Active. Los identificadores de elemento de datos deben asignarse en una serie contigua, empezando por 1. El identificador de datos de un elemento determina el orden en que aparece el elemento en una instancia del bloque de datos; el orden de los elementos de la definición de clase MOF es irrelevante.

WmiMethodId(method-item-ID)

Identifica un método dentro de un bloque de datos.

WmiSizeIs("data-item-name")

Especifica el nombre de otro elemento de datos de este bloque que indica el número de elementos de la matriz de longitud variable en este elemento de datos. WmiSizeIs solo es válido para los elementos de datos que definen matrices.

WmiScale(scale-factor)

Especifica el factor de escalado, como potencia de 10, que el controlador usa al devolver el valor de este elemento de datos. Por ejemplo, si el factor de escala es 5, el valor devuelto por el controlador se multiplica por 10⁵. Si se omite WmiScale , se puede suponer que el factor de escala es 0.

WmiTimeStamp

Especifica que un elemento de datos de 64 bits es una marca de tiempo en unidades de 100 nanosegundos desde 1/1/1601. WmiTimeStamp solo es válido para elementos de datos de 64 bits.

WmiComplexity(level)

Especifica un valor entero que expresa el nivel de complejidad del usuario del elemento de datos. Los clientes WMI pueden usar ese valor para distinguir entre elementos de datos que deben estar disponibles para usuarios principiantes y elementos de datos que deben restringirse a usuarios más avanzados. Cero es el valor mínimo y los valores más altos indican una mayor complejidad del usuario. WmiComplexity tiene como valor predeterminado cero si no se especifica.

WmiVolatility(interval)

Especifica el intervalo, en milisegundos, entre las actualizaciones de este elemento de datos. Por ejemplo, si un elemento de datos se actualiza una vez por segundo, el intervalo sería 1000. Un cliente WMI puede comprobar WmiVolatility para determinar con qué frecuencia se consulta un valor potencialmente nuevo. Si se omite WmiVolatility , el intervalo no está definido.

WmiEventTrigger("data-item-name")

Especifica el nombre de un elemento de datos en un bloque de eventos que un cliente WMI puede establecer para definir el valor del desencadenador para el evento. Por ejemplo, si el evento TooHot está calificado con WmiEventTrigger("TooHotTemperature"), un cliente WMI podría establecer TooHotTemperature para indicar al controlador que envíe el evento TooHot cuando el dispositivo alcanzó el valor especificado por el usuario para TooHotTemperature. Normalmente, un controlador definiría el valor del desencadenador. Al exponer un elemento de datos WmiEventTrigger , el controlador permite a un cliente controlar cuándo se desencadena un evento determinado.

WmiEventRate("data-item-name")

Especifica el nombre de un elemento de datos en un bloque de eventos que un cliente WMI puede establecer para controlar la frecuencia con la que se enviará este evento. Por ejemplo, si el elemento de datos TooHot está calificado con WmiEventRate("SendEventRate"), un usuario cliente WMI podría establecer SendEventRate para indicar al controlador que envíe TooHot en el intervalo especificado por el usuario.