Partilhar via

Qualificadores WMI padrão

A lista a seguir lista qualificadores padrão específicos para WMI.

Alteração

Tipo de dados: booleano

Aplica-se a: classes

Indica que uma classe contém qualificadores alterados que estão localizados. O padrão é TRUE.

A classe associada pode ser traduzida. Para acessar a versão traduzida, use o identificador de localidade para construir um nome de namespace.

Bypass_GetObject

Tipo de dados: booleano

Aplica-se a: métodos

Indica que a chamada de método deve passar diretamente para a chamada ExecMethodAsync do provedor em vez de o provedor primeiro fazer uma chamada para GetObject para validar o caminho do objeto. O padrão é FALSE. O uso Bypass_GetObject pode melhorar significativamente o desempenho.

Antes de usar Bypass_GetObject, certifique-se de que nenhuma das seguintes ações seja executada:

  • Derive uma classe da sua classe.
  • Substitua o método que tem o qualificador Bypass_GetObject .

A falha em seguir essas precauções pode resultar em invocar a implementação do método da classe pai em vez da classe filha. Para obter mais informações, consulte Usando o qualificador de Bypass_GetObject.

CIM_Key

Tipo de dados: CIM_BOOLEAN

Aplica-se a: propriedades

Indica que a propriedade associada é uma propriedade chave no CIM, mas não no WMI.

CIMTipo

Tipo de dados: VT_BSTR

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

Contém texto que descreve o tipo de uma propriedade.

ClassContext

Tipo de dados: VT_BSTR

Aplica-se a: classes

Indica que uma classe tem instâncias associadas a mais informações fornecidas dinamicamente por um provedor.

Preterido

Tipo de dados: CIM_BOOLEAN

Aplica-se a: propriedades, classes

Indica que a propriedade foi substituída por outra propriedade.

Ecrã

Aplica-se a: classes, propriedades

O UUID da classe associada.

Dinâmica

Tipo de dados: booleano

Aplica-se a: classes, propriedades

Indica uma classe cujas instâncias são criadas dinamicamente. O valor deste qualificador deve ser definido como TRUE.

DynProps

Tipo de dados: booleano

Aplica-se a: classes, instâncias

Indica que uma instância contém valores fornecidos por provedores de propriedades dinâmicas. O padrão é TRUE.

Você deve especificar esse qualificador em tal instância. Apenas o valor TRUE é permitido.

Fixo

Tipo de dados: CIM_BOOLEAN

Aplica-se a: instâncias

Indica que o valor dessa propriedade não pode ser alterado durante o tempo de vida da instância.

Identificação

Tipo de dados: VT_I4

Aplica-se a: propriedades, parâmetros

Identifica e sequencia exclusivamente uma propriedade ou parâmetro de método quando as instruções MOF são geradas automaticamente.

Este qualificador é necessário apenas para parâmetros de método. Ao criar parâmetros para um método, os designers de classe devem começar com Id(0) para o primeiro parâmetro e usar cada inteiro sucessivo para cada parâmetro sucessivo. Se os qualificadores de ID forem omitidos involuntariamente, o compilador MOF gerará qualificadores de ID automaticamente.

Implementado

Tipo de dados: booleano

Aplica-se a: métodos

Indica que um método tem uma implementação fornecida por um provedor.

InstanceContext

Tipo de dados: VT_BSTR

Aplica-se a: instâncias

Indica que uma instância contém valores fornecidos por um provedor de propriedade dinâmica.

O valor é passado para o provedor de propriedade como um argumento para o método IWbemPropertyProvider::GetProperty .

Localidade

Tipo de dados: VT_BSTR

Aplica-se a: classes ou instâncias

Especifica o idioma de origem de uma classe ou instância. Para obter mais informações sobre valores de localidade, consulte Códigos de localidade.

NamespaceSecuritySDDL

Tipo de dados: string array

Aplica-se a: instâncias de namespace

Especifica um descritor de segurança para o namespace no formato SDDL . Para obter mais informações, consulte Definindo a segurança do namespace quando o namespace é criado. A cadeia de caracteres SDDL é processada pelo WMI para estabelecer a segurança do namespace, mas não é armazenada como uma cadeia de caracteres. Se nenhum descritor de segurança for especificado, a segurança padrão será usada. Para obter mais informações, consulte Definindo descritores de segurança de namespace.

Opcional

Tipo de dados: booleano

Aplica-se a: parâmetros

Indica que um parâmetro não é necessário e que ele tem um valor padrão bem comportado.

Privilégios

Tipo de dados: string array

Aplica-se a: propriedades, métodos

Conjunto de valores usados para informar ao cliente quais privilégios são necessários para criar instâncias, preencher propriedades ou executar métodos. O padrão é FALSE.

PropertyContext

Tipo de dados: VT_BSTR

Aplica-se a: propriedades

Indica que uma propriedade de instância contém valores fornecidos por provedores de propriedades dinâmicas.

Você deve especificar esse qualificador em tal propriedade. O valor é passado para o provedor de propriedade como um argumento para IWbemPropertyProvider::GetProperty.

Provedor

Tipo de dados: VT_BSTR

Aplica-se a: classes

O valor desse qualificador é o nome do provedor dinâmico que fornece instâncias de classe e atualiza os dados da instância. Esse nome deve ser registrado no WMI criando uma instância da classe __Win32Provider com a propriedade Name que contém esse nome. Quando esse qualificador é especificado em uma classe cujas instâncias são fornecidas dinamicamente, o qualificador Dinâmico também deve ser especificado.

RequiresEncryption

Tipo de dados: booleano

Aplica-se a: instâncias de namespace

Se definido como TRUE,RequiresEncryption marca um namespace para que os aplicativos cliente e scripts devem se conectar com autenticação criptografada. O nível de autenticação deve ser definido como RPC_C_AUTHN_LEVEL_PKT_PRIVACY em C++. Em scripts ou Visual Basic, o nível de autenticação deve ser definido como WbemAuthenticationLevelPktPrivacy. Para obter mais informações, consulte Definindo descritores de segurança de namespace. O qualificador é usado no MOF com o comando pragma namespace preprocessor.

Para obter mais informações, consulte Definindo o nível de segurança de processo padrão usando C++ ou Definindo o nível de segurança de processo padrão usando VBScript. Os níveis de autenticação de script são definidos em WbemAuthenticationLevelEnum.

Singleton

Tipo de dados: booleano

Aplica-se a: classes

Designa uma classe que só pode ter uma instância e que não contém propriedades de chave.

Somente o valor TRUE (padrão) é permitido.

Estática

Tipo de dados: booleano

Aplica-se a: métodos

Indica se um método pode ser chamado usando a definição de classe ou suas instâncias.

O método não pode ser invocado a partir de uma instância.

Subtipo

Tipo de dados: VT_BSTR

Aplica-se a: propriedades

Indica que uma propriedade do tipo CIM_DATETIME representa um intervalo de tempo em vez de um tempo específico.

Para identificar a propriedade como um intervalo, o valor desse qualificador deve ser "intervalo". Todos os outros valores para este qualificador são reservados para uso futuro.

UUID

Tipo de dados: string

Aplica-se a: classes

Identificador universalmente exclusivo aplicado à classe.

ClassVersion

Tipo de dados: string

Aplica-se a: classes

O número da versão do objeto de classe. O padrão é NULL. O número da versão é incrementado quando são feitas alterações na classe.

WritePrivileges

Tipo de dados: string array

Aplica-se a: propriedades

Conjunto de valores indicando quais privilégios do sistema devem estar disponíveis e habilitados para uma operação de gravação bem-sucedida.

Observações

Códigos de localidade

Um código de localidade tem o formato "MS_<ID de idioma> de três dígitos". Por exemplo, a localidade em inglês é MS_409. A tabela a seguir lista os IDs de idioma.

Língua ID do idioma (hexadecimal)
Árabe 401
Português (Brasil) 416
Chinês (simplificado) 804
Chinês (tradicional) 404
Checo 405
Dinamarquês 406
Holandês 413
Inglês (padrão) 409
Finlandês 40 ter
Francês 40 centímetros
Alemão 407
Grego 408
Hebraico 40d
Húngaro 40º
Italiano 410
Japonês 411
Coreano 412
Norueguês 414
Polaco 415
Português (Portugal) 816
Russo 419
Espanhol C0A
Sueco 41D
Turco (língua) 41 F

Usando o qualificador de Bypass_GetObject

Usar o qualificador Bypass_GetObject em um método pode produzir resultados confusos.

O exemplo a seguir define as classes Shape e Circle . Observe que a classe Circle é derivada da classe Shape .

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

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

A chamada a seguir para ExecMethod usa um objeto Circle chamado "MyCircle" para desenhar um círculo.

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

No cenário anterior, o WMI chama GetObject; descobre que "Shape.Name='MyCircle'" é um Círculo; e executa a implementação Circle do DrawIt. No entanto, se você usar o qualificador Bypass_GetObject em DrawIt, o WMI não chamará GetObject, não descobrirá que "Shape.Name='MyCircle'" é um Circle e executará a implementação Shape de DrawIt em vez da implementação Circle de DrawIt.

A chamada a seguir para ExecMethod sempre invoca a implementação correta de DrawIt.

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

Requerimentos

Requisito Valor
Cliente mínimo suportado
 Windows Vista
Servidor mínimo suportado
 Windows Server 2008

Ver também

Definindo descritores de segurança de namespace

Qualificatórios WMI

Adicionando um qualificador

  • Last updated on