Qualificadores de propriedade WMI
A tabela a seguir lista os qualificadores de propriedade MOF obrigatórios e opcionais que podem ser usados para definir itens em um bloco de eventos ou dados WMI.
A seguir estão os qualificadores MOF padrão: key, read, write, ValueMap e Values. Para obter mais informações sobre esses e outros qualificadores MOF padrão, consulte Tipos de dados MOF.
| Qualificador | Descrição |
|---|---|
chave |
Indica que o item de dados é uma propriedade de chave que identifica exclusivamente cada instância da classe. Somente a propriedade InstanceName pode ser declarada uma chave. |
read |
Indica que um cliente WMI pode ler o item de dados. |
write |
Indica que um cliente WMI pode definir o item de dados. |
Mapa de bits |
Especifica as posições de bit dos valores de cadeia de caracteres correspondentes especificados em BitValues. |
Valores de bits |
Especifica uma lista de valores de cadeia de caracteres (nomes de sinalizador) que representam bits definidos no item de dados. A posição de bit de um sinalizador é definida pela posição correspondente especificada em BitMap. |
DefinirValores |
Especifica uma lista enumerada que o conjunto de ferramentas WMI compila em uma lista correspondente de instruções #define. |
DisplayInHex |
Especifica que qualquer cliente WMI que exiba o valor da propriedade deve fazê-lo em hexadecimal. |
DisplayName("cadeia de caracteres") |
Especifica uma legenda que um cliente WMI pode usar para exibir como o nome da propriedade. |
MaxLen(uint) |
Para propriedades de cadeia de caracteres, MaxLen especifica o comprimento máximo da cadeia de caracteres em caracteres. O valor uint pode ser qualquer inteiro sem sinal de 32 bits. Se MaxLen for omitido ou uint for zero, o comprimento da cadeia de caracteres será ilimitado. |
Valores |
Especifica uma lista de valores possíveis para esse item de dados. Se o item de dados for uma enumeração, ValueMap conterá o valor de índice que corresponde ao valor de enumeração especificado em Valores. |
Mapa de valor |
Especifica os valores inteiros dos valores de cadeia de caracteres correspondentes em Valores. |
WmiDataId(ID do item de dados) |
(Obrigatório) Identifica um item de dados dentro de um bloco de dados. As IDs de item de dados devem ser atribuídas a todos os itens em um bloco, exceto aos itens obrigatórios InstanceName e Active. As IDs de item de dados devem ser atribuídas em uma série contígua, começando com 1. A ID de dados de um item determina a ordem em que o item aparece em uma instância do bloco de dados; a ordem dos itens na definição da classe MOF é irrelevante. |
WmiMethodId(ID do item do método) |
Identifica um método dentro de um bloco de dados. |
WmiSizeIs("nome-do-item-de-dados") |
Especifica o nome de outro item de dados neste bloco que indica o número de elementos na matriz de comprimento variável neste item de dados. WmiSizeIs é válido apenas para itens de dados que definem matrizes. |
WmiScale(fator de escala) |
Especifica o fator de dimensionamento, como uma potência de 10, que o driver usa ao retornar o valor desse item de dados. Por exemplo, se o fator de escala for 5, o valor retornado pelo driver será multiplicado por 10⁵. Se WmiScale for omitido, o fator de escala poderá ser considerado 0. |
Carimbo de data/hora |
Especifica que um item de dados de 64 bits é um carimbo de data/hora em unidades de 100 nanossegundos desde 1/1/1601. WmiTimeStamp é válido apenas para itens de dados de 64 bits. |
WmiComplexity(nível) |
Especifica um valor inteiro que expressa o nível de complexidade do usuário do item de dados. Os clientes WMI podem usar esse valor para distinguir entre itens de dados que devem estar disponíveis para usuários iniciantes e itens de dados que devem ser restritos a usuários mais avançados. Zero é o valor mínimo e valores mais altos indicam maior complexidade do usuário. O padrão WmiComplexity é zero se não for especificado. |
WmiVolatility(intervalo) |
Especifica o intervalo, em milissegundos, entre as atualizações desse item de dados. Por exemplo, se um item de dados for atualizado uma vez a cada segundo, o intervalo será 1000. Um cliente WMI pode verificar WmiVolatility para determinar com que frequência consultar um valor potencialmente novo. Se WmiVolatility for omitido, interval será indefinido. |
WmiEventTrigger( " nome-do-item-de-dados") |
Especifica o nome de um item de dados em um bloco de eventos que um cliente WMI pode definir para definir o valor do gatilho para o evento. Por exemplo, se o evento TooHot for qualificado com WmiEventTrigger("TooHotTemperature"), um cliente WMI poderá definir TooHotTemperature para instruir o driver a enviar o evento TooHot quando o dispositivo atingir o valor especificado pelo usuário para TooHotTemperature. Normalmente, um driver definiria o valor do gatilho. Ao expor um item de dados WmiEventTrigger , o driver permite que um cliente controle quando um evento específico é disparado. |
WmiEventRate("nome do item de dados") |
Especifica o nome de um item de dados em um bloco de eventos que um cliente WMI pode definir para controlar a frequência com que esse evento será enviado. Por exemplo, se o item de dados TooHot for qualificado com WmiEventRate("SendEventRate"), um usuário cliente WMI poderá definir SendEventRate para instruir o driver a enviar TooHot no intervalo especificado pelo usuário. |