Qualificadores padrão

Todas as implementações em conformidade com CIM devem lidar com um conjunto de qualificadores padrão. Qualquer objeto específico não tem todos os qualificadores listados. Normalmente, as classes de extensão fornecem qualificadores adicionais para facilitar o provisionamento de instâncias de classe e outras operações na classe.

É responsabilidade do provedor impor os qualificadores. O WMI não impõe qualificadores, mas os usa apenas para informar o usuário sobre como a propriedade é usada.

Observação

O WMI está em conformidade com a especificação CIM 2.5.

Os qualificadores têm as seguintes limitações:

• Nem todos os qualificadores padrão podem ser usados juntos.
• Nem todos os qualificadores podem ser aplicados a todos os constructos, como associação ou referência. Essas limitações são identificadas na lista Aplica-se a.
• Para um constructo específico, como associação ou referência, o uso dos qualificadores legais pode ser restringido ainda mais porque alguns qualificadores são mutuamente exclusivos. O uso de um qualificador pode implicar em algumas restrições sobre o valor de outro e assim por diante. Essas regras de uso estão documentadas.
• Os qualificadores legais são herdados por entidades, como propriedades, métodos, instâncias ou subclasses, não por associações ou referências. Por exemplo, o qualificador MaxLen que se aplica às propriedades não é herdado por referências.

Veja a seguir uma lista dos qualificadores padrão do WMI.

Abstract

Tipo de dados: booliano

Aplica-se a: classes, associações, indicações

Indica se a classe é abstrata e serve apenas como base para novas classes. O padrão é FALSE. Não é possível criar instâncias de classes abstratas. A ausência desse qualificador indica que a classe não é abstrata. Portanto, esse qualificador é necessário para todas as classes abstratas.

Aggregate

Tipo de dados: booliano

Aplica-se a: referências

Indica se a referência é o componente pai de uma associação de agregação. O padrão é FALSE.

Uso: os qualificadores de Aggregation e Aggregate são usados juntos Aggregation qualifica a associação e Aggregate especifica a referência pai.

Aggregation

Tipo de dados: booliano

Aplica-se a: associações

Indica se a associação é uma agregação. O padrão é FALSE. Usado com Aggregate. Esse qualificador é necessário para todas as associações de agregação.

Alias

Tipo de dados: cadeia de caracteres

Aplica-se a: propriedades, referências, métodos

Nome alternativo para uma propriedade ou método no esquema. O padrão é NULL.

ArrayType

Tipo de dados: cadeia de caracteres

Aplica-se a: propriedades, parâmetros

Tipo da matriz qualificada.

Os valores válidos são:

• bag (padrão)
• indexado
• ordered

Uso: aplique esse tipo de qualificador somente a propriedades e parâmetros que são matrizes (definidos usando a sintaxe de colchete).

BitMap

Tipo de dados: matriz de cadeia de caracteres

Aplica-se a: propriedades, métodos, parâmetros

Mapa de posições de bit significativas em que cada posição significativa pode estar "ativada" ou "desativada". Cada bit "ativado" é mapeado para um valor correspondente na matriz BitValues. Ao ter vários bits "ativados", vários valores simultâneos na matriz BitValues são indicados. O padrão é NULL.

Para obter mais informações, confira BitMap e BitValues.

BitValues

Tipo de dados: matriz de cadeia de caracteres

Aplica-se a: propriedades, métodos, parâmetros

Tradução de um valor de posição de bit em uma cadeia de caracteres associada. O padrão é NULL.

Para obter mais informações, confira BitMap e BitValues.

Constructor

Tipo de dados: booliano

Aplica-se a: métodos

Indica se o método cria instâncias. Esses métodos não são restritos a atuar em uma única instância ou em uma única classe. Por exemplo, um construtor pode criar instâncias de associação, bem como instâncias da classe que define o construtor.

O qualificador Constructor destina-se apenas a informações e não é esperado que ele seja influenciado pelo gerenciador de objetos. O gerenciador de objetos não precisa chamar métodos de construtor quando um objeto é criado. Além disso, quando um construtor é chamado, o gerenciador de objetos não precisa invocar um método de construtor definido para classes pai da classe original. O padrão é FALSE.

CreateBy

Tipo de dados: cadeia de caracteres

Aplica-se a: classes

Nome do método pelo qual as instâncias dessa classe são criadas. O valor é "PutInstance" ou o nome de outro método que cria as instâncias. O padrão é NULL.

Uso: esse qualificador só poderá ser usado se o qualificador SupportsCreate estiver presente.

DeleteBy

Tipo de dados: cadeia de caracteres

Aplica-se a: classes

Nome do método pelo qual as instâncias dessa classe são excluídas. O valor é "DeleteInstance" ou o nome de outro método que exclui as instâncias. O padrão é NULL.

Uso: esse qualificador só poderá ser usado se o qualificador SupportsDelete estiver presente.

Description

Tipo de dados: cadeia de caracteres

Aplica-se a: qualquer conceito

Descrição de um elemento nomeado. O padrão é NULL.

Destructor

Tipo de dados: booliano

Aplica-se a: métodos

Indica se o método exclui instâncias. Os métodos que usam o qualificador Destructor excluem as instâncias às quais o destruidor é aplicado e não são restritos a influenciar uma única instância ou classe. Por exemplo, um destruidor pode excluir instâncias de associação, bem como instâncias da classe que define o destruidor.

O qualificador Destructor destina-se apenas a informações e não é esperado que ele seja influenciado pelo gerenciador de objetos. Não é obrigatório que o gerenciador de objetos chame um método que tenha o qualificador Destructor, quando uma instância é excluída. Além disso, quando um destruidor é chamado, o gerenciador de objetos não precisa invocar um método de destruidor definido para classes pai da classe original. O padrão é FALSE.

DisplayName

Tipo de dados: cadeia de caracteres

Aplica-se a: qualquer conceito

Nome exibido na interface do usuário, em vez do nome real do elemento. O padrão é NULL.

EmbeddedInstance

Tipo de dados: cadeia de caracteres

Aplica-se a: qualquer conceito

O elemento de tipo de cadeia de caracteres qualificado contém uma instância inserida. O valor do qualificador especifica o nome de uma classe CIM no mesmo namespace que a classe que possui o elemento qualificado. A instância inserida é uma instância da classe especificada, incluindo instâncias das subclasses. O padrão é NULL.

Gauge

Tipo de dados: booliano

Aplica-se a: qualquer conceito

Indica se a propriedade representa um inteiro não negativo, que pode aumentar ou diminuir, mas nunca excede um valor máximo. O padrão é FALSE.

O valor máximo da propriedade não pode ser maior que 2^n - 1. N pode ser 8, 16, 32 ou 64, dependendo do tipo de dados da propriedade à qual esse qualificador é aplicado. O valor de um medidor tem seu valor máximo sempre que as informações que estão sendo modeladas são maiores ou iguais a esse valor máximo. Se as informações que estão sendo modeladas diminuírem posteriormente a ponto de ficar abaixo do valor máximo, o medidor também diminuirá. Esse qualificador é aplicável somente a propriedades com um tipo de dados inteiro sem sinal.

In

Tipo de dados: booliano

Aplica-se a: parâmetros

Indica se o parâmetro é usado para passar valores para um método. O valor padrão é TRUE.

In, Out

Tipo de dados: booliano

Aplica-se a: parâmetros

Indica se o parâmetro é um parâmetro de entrada e saída.

Key

Tipo de dados: booliano

Aplica-se a: propriedades, referências

Indica se a propriedade faz parte do identificador do namespace. Se mais de uma propriedade tiver o qualificador Key, todas elas formarão coletivamente a chave (uma chave composta). Quando juntas, as propriedades de chave devem fornecer uma referência exclusiva para cada instância de classe. Se esse qualificador for colocado em uma propriedade, somente o valor TRUE será permitido.

Lazy

Aplica-se a: propriedades

Indica que a propriedade tem uso intensivo de recursos para retornar e requer muito tempo e memória do processador. O WMI melhora o desempenho das consultas ao não tentar retornar as propriedades marcadas com o qualificador Lazy.

MappingStrings

Tipo de dados: matriz de cadeia de caracteres

Aplica-se a: classes, propriedades, associações, indicações, referências

Conjunto de valores que indicam um caminho para um local em que você pode encontrar mais informações sobre a origem de uma propriedade, classe, associação, indicação ou referência. A cadeia de caracteres de mapeamento pode ser um caminho de diretório, uma URL, uma chave do registro, um arquivo de inclusão, uma referência a uma classe CIM ou algum outro formato. O padrão é NULL.

Max

Tipo de dados: int

Aplica-se a: referências

Número máximo de valores que determinada referência pode ter para cada conjunto de outros valores de referência na associação. O padrão é NULL. Por exemplo, se uma associação relaciona as instâncias A às instâncias B e deve haver no máximo uma instância A para cada instância B, a referência à A deve ter no máximo um qualificador.

MaxLen

Tipo de dados: int

Aplica-se a: propriedades, métodos, parâmetros

Comprimento máximo (em caracteres) de um item de dados de cadeia de caracteres e indica suporte a matrizes de comprimento fixo.

Se uma matriz de comprimento fixo for encontrada, o qualificador MaxLen conterá o comprimento fixo encontrado durante a análise. Se uma matriz de comprimento variável for encontrada, esse qualificador não será usado. MaxLen é usado para sugerir o número máximo de elementos que devem ser armazenados em uma matriz. Ao substituir o valor padrão, qualquer valor inteiro sem sinal (uint32) pode ser especificado. Um valor NULL (padrão) implica em comprimento ilimitado.

MaxValue

Tipo de dados: int

Aplica-se a: propriedades, métodos, parâmetros

Valor máximo do objeto. O padrão é NULL.

Min

Tipo de dados: int

Aplica-se a: referências

Cardinalidade mínima da referência (o número mínimo de valores que determinada referência pode ter para cada conjunto de outros valores de referência na associação). O padrão é 0.

Por exemplo, se uma associação relaciona as instâncias A às instâncias B e deve haver no mínimo uma instância A para cada instância B, a referência à A deve ter no mínimo um qualificador.

MinValue

Tipo de dados: int

Aplica-se a: propriedades, métodos, parâmetros

Indica o valor mínimo do objeto. O padrão é NULL.

ModelCorrespondence

Tipo de dados: matriz de cadeia de caracteres

Aplica-se a: propriedades

Conjunto de valores que indicam correspondência entre a propriedade de um objeto e outras propriedades no esquema CIM. O padrão é NULL.

As propriedades do objeto são identificadas usando a sintaxe a seguir.

<nome> do esquema "_" <classe ou nome> de associação "." <nome da propriedade>

Nonlocal

Tipo de dados: cadeia de caracteres

Aplica-se a: referências

Local de uma instância, cujo valor é <namespacetype>://<namespacehandle> O padrão é NULL.

Uso: este qualificador não pode ser usado com o qualificador NonlocalType.

NonlocalType

Tipo de dados: cadeia de caracteres

Aplica-se a: referências

Tipo de local de uma instância. Seu valor é <namespacetype>. O padrão é NULL.

Uso: este qualificador não pode ser usado com o qualificador Nonlocal.

NullValue

Tipo de dados: cadeia de caracteres

Aplica-se a: propriedades

Valor que indica que a propriedade associada é NULL (a propriedade não tem um valor válido ou significativo). O padrão é NULL.

As convenções e restrições usadas para definir valores NULL são as mesmas aplicáveis ao qualificador ValueMap. Note que esse qualificador não pode ser substituído. Não é aceitável permitir que uma subclasse retorne um valor NULL diferente do da classe pai.

Out

Tipo de dados: booliano

Aplica-se a: parâmetros

Indica se o parâmetro retorna valores de um método. O padrão é FALSE.

Override

Tipo de dados: cadeia de caracteres

Aplica-se a: propriedades, métodos, referências

Classe pai ou constructo subordinado (propriedade, método ou referência) que é substituído pela propriedade, método ou referência do mesmo nome na classe derivada. O padrão é NULL.

O formato é:

[<classe>.]<constructo subordinado>

Se o nome da classe for omitido, a substituição se aplicará ao constructo subordinado na classe pai na hierarquia de classe.

Uso: o qualificador Override pode se referir a constructos com base apenas no mesmo modelo meta. Não é permitido alterar um nome de constructo ou assinatura durante uma operação de substituição.

OverrideValue

Aplica-se a: classes

Indica se o valor da propriedade em uma subclasse substitui o valor em uma classe pai. A implicação funcional é que, se você executar uma consulta na classe pai e se a cláusula WHERE incluir essa propriedade, o pai deverá retornar uma instância com o valor substituído. Como resultado, o Gerenciamento do Windows ajusta a cláusula WHERE da consulta enviada à classe pai, para excluir as referências a essa propriedade.

Propagated

Tipo de dados: cadeia de caracteres

Aplica-se a: propriedades

Nome da chave que está sendo propagada. O padrão é NULL.

O uso desse qualificador pressupõe a existência de apenas um qualificador fraco em uma referência que tem a classe que contém como destino. A propriedade associada deve ter o mesmo valor que a propriedade nomeada pelo qualificador na classe do outro lado da associação fraca. O formato é:

[<classe>.]<constructo subordinado>

Uso: quando o qualificador Propagated é usado, o qualificador Key deve ser especificado com um valor TRUE.

Read

Tipo de dados: booliano

Aplica-se a: propriedades

Indica se a propriedade é legível. O valor padrão é TRUE.

Required

Tipo de dados: booliano

Aplica-se a: propriedades

Indica se um valor não nulo é necessário para a propriedade. O padrão é FALSE.

Revision

Tipo de dados: cadeia de caracteres

Aplica-se a: classes, associações, indicações, esquemas

Número de revisão secundária do objeto de esquema. O padrão é NULL.

Uso: o qualificador Version deve estar presente para fornecer o número de versão principal, quando o qualificador Revision for usado.

Schema

Tipo de dados: cadeia de caracteres

Aplica-se a: propriedades, métodos

Nome do esquema no qual o recurso é definido. O padrão é NULL.

Source

Tipo de dados: cadeia de caracteres

Aplica-se a: classes, associações, indicações, referências

Local de uma instância. O padrão é NULL.

O valor do qualificador é <namespacetype>://<namespacehandle>.

Uso: o qualificador Source não pode ser usado com o qualificador SourceType.

SourceType

Tipo de dados: cadeia de caracteres

Aplica-se a: classes, associações, indicações, referências

Tipo de local de uma instância. O valor desse qualificador é <namespacetype>. O padrão é NULL.

Uso: o qualificador SourceType não pode ser usado com o qualificador Source.

SupportsCreate

Tipo de dados: booliano

Aplica-se a: classes

Indica se a classe dá suporte à criação de instâncias. O padrão é FALSE.

SupportsDelete

Tipo de dados: booliano

Aplica-se a: classes

Indica se a classe dá suporte à exclusão de instâncias. O padrão é FALSE.

SupportsUpdate

Tipo de dados: booliano

Aplica-se a: classes

Indica se a classe dá suporte à modificação (atualização) das instâncias. O padrão é FALSE.

Terminal

Tipo de dados: booliano

Aplica-se a: classes

Indica se a classe pode ter subclasses. O padrão é FALSE.

Se uma subclasse for declarada, o compilador gerará um erro.

Uso: esse qualificador não pode coexistir com o qualificador Abstract . Se os qualificadores Terminal e Abstract forem especificados, o compilador gerará um erro.

Units

Tipo de dados: cadeia de caracteres

Aplica-se a: propriedades, métodos, parâmetros

Tipo de unidade na qual o item de dados associado é expresso. O padrão é NULL.

Por exemplo, um item de dados de tamanho pode ter um valor de "bytes" para Units.

ValueMap

Tipo de dados: matriz de cadeia de caracteres

Aplica-se a: propriedades, métodos, parâmetros

Conjunto de valores permitidos para uma propriedade, tipo de retorno de método ou parâmetro de método. O padrão é NULL.

Uso: esse qualificador pode ser usado isoladamente ou em combinação com o qualificador Values. Quando usado em combinação com o qualificador Values, o local do valor na matriz ValueMap fornece o local da entrada correspondente na matriz Values. Use o qualificador ValueMap apenas com valores de cadeia de caracteres e inteiros. A sintaxe para representar um valor inteiro na matriz de mapa de valor é [+|=]digit[*digit]. O conteúdo, o número máximo de dígitos e o valor representado são restritos pelo tipo da propriedade associada. Por exemplo, uint8 pode não estar assinado, deve ter menos de quatro dígitos e deve representar um valor menor que 256.

Values

Tipo de dados: matriz de cadeia de caracteres

Aplica-se a: propriedades, métodos, parâmetros

Conjunto de valores que convertem um valor inteiro em uma cadeia de caracteres associada. O padrão é NULL.

Essa propriedade também especifica uma matriz de valores de cadeia de caracteres a serem mapeados para uma propriedade de enumeração. Esse qualificador pode ser aplicado a uma propriedade de inteiro ou a uma propriedade de cadeia de caracteres, e o mapeamento pode ser implícito ou explícito. Se o mapeamento for implícito, os valores de propriedade de inteiro ou de cadeia de caracteres representarão posições ordinais na matriz Values. Se o mapeamento for explícito, a propriedade deverá ser um inteiro e os valores de propriedade válidos serão listados na matriz definida pelo qualificador ValueMap. Para saber mais, confira Mapa de Valores.

Se um qualificador ValueMap não estiver presente, a matriz Values será indexada (relativa a zero) usando o valor na propriedade associada, tipo de retorno de método ou parâmetro de método. Se um qualificador ValueMap estiver presente, o índice de valores será definido pelo local do valor da propriedade no mapa de valores.

Version

Tipo de dados: cadeia de caracteres

Aplica-se a: classes, esquemas, associações, indicações

Número de versão principal do objeto de esquema. O padrão é NULL. O número de versão é incrementado quando são feitas alterações no esquema que alteram a interface.

Weak

Tipo de dados: booliano

Aplica-se a: referências

Indica se as chaves da classe referenciada incluem as chaves dos outros participantes na associação. O padrão é FALSE.

Esse qualificador é usado quando a identidade da classe referenciada depende da identidade dos outros participantes na associação. No máximo, uma referência a determinada classe pode ser fraca. As outras classes na associação devem definir uma chave. As chaves das outras classes na associação são repetidas na classe referenciada e são marcadas com um qualificador Propagated.

Write

Tipo de dados: booliano

Aplica-se a: propriedades

Indica que aplicativos ou scripts podem alterar o valor da propriedade. A conta que executa o aplicativo deve ter acesso ao namespace que contém instâncias da classe . A implementação do provedor também pode limitar o acesso aos dados do provedor. Um valor TRUE indica que a propriedade é legível e gravável para consumidores que têm permissão de acesso no WMI e no provedor. O padrão é FALSE.

Uma propriedade que não tem o qualificador Write ainda pode ser gravável. A implementação do provedor pode permitir que todas as propriedades nas classes de provedor sejam alteradas, independentemente da presença do qualificador Write.

WriteAtCreate

Tipo de dados: booliano

Aplica-se a: propriedades

Indica se a propriedade é gravável na criação da instância. Esse qualificador pode ser usado em conjunto com o qualificador WriteAtCreate. O padrão é FALSE.

WriteAtUpdate

Tipo de dados: booliano

Aplica-se a: propriedades

Indica se a propriedade é gravável na atualização da instância. Esse qualificador pode ser usado em conjunto com o qualificador WriteAtCreate. O padrão é FALSE.

Exemplos

Para obter mais informações sobre como recuperar qualificadores, confira o exemplo de código Get-WmiClassMethodsAndWritableWmiProperties do PowerShell na Galeria do TechNet.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008

Confira também

Qualificadores do WMI

Como adicionar um qualificador