Qualificadores WMI padrão
As listas a seguir listam qualificadores padrão específicos ao WMI.
Alteração
Tipo de dados: booliano
Aplica-se a: classes
Indica que uma classe contém qualificadores alterados 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: booliano
Aplica-se a: métodos
Indica que a chamada de método deve passar diretamente para a chamada ExecMethodAsync do provedor em vez do provedor primeiro fazer uma chamada para GetObject para validar o caminho do objeto. O padrão é FALSE. Usar 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 de sua classe.
- Substitua o método que tem o qualificador Bypass_GetObject .
Não seguir essas precauções pode resultar na invocação da implementação do método da classe pai em vez da classe filho. 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.
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.
Exibir
Aplica-se a: classes, propriedades
A UUID da classe associada.
Tipo de dados: booliano
Aplica-se a: classes, propriedades
Indica uma classe cujas instâncias são criadas dinamicamente. O valor desse qualificador deve ser definido como TRUE.
DynProps
Tipo de dados: booliano
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. Somente 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.
ID
Tipo de dados: VT_I4
Aplica-se a: propriedades, parâmetros
Identifica e sequencia exclusivamente um parâmetro de propriedade ou método quando instruções MOF são geradas automaticamente.
Esse 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 sem querer, o compilador MOF gerará qualificadores de ID automaticamente.
Implementado
Tipo de dados: booliano
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 propriedades dinâmicas.
O valor é passado para o provedor de propriedades 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 para uma classe ou instância. Para obter mais informações sobre valores de localidade, consulte Códigos de Localidade.
NamespaceSecuritySDDL
Tipo de dados: matriz de cadeia de caracteres
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 Configurando a segurança do namespace quando o namespace for 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 Configurando descritores de segurança do Namepace.
Opcional
Tipo de dados: booliano
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: matriz de cadeia de caracteres
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 propriedades 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: booliano
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 a autenticação criptografada. O nível de autenticação deve ser definido como RPC_C_AUTHN_LEVEL_PKT_PRIVACY em C++. No script ou Visual Basic, o nível de autenticação deve ser definido como WbemAuthenticationLevelPktPrivacy. Para obter mais informações, consulte Configurando descritores de segurança do Namepace. O qualificador é usado no MOF com o comando pré-processador de namespace pragma.
Para obter mais informações, consulte Como definir o nível de segurança do processo padrão usando C++ ou definir o nível de segurança do processo padrão usando o VBScript. Os níveis de autenticação de script são definidos em WbemAuthenticationLevelEnum.
Singleton
Tipo de dados: booliano
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ático
Tipo de dados: booliano
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 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 "interval". Todos os outros valores para este qualificador são reservados para uso futuro.
UUID
Tipo de dados: cadeia de caracteres
Aplica-se a: classes
Identificador universalmente exclusivo aplicado à classe.
ClassVersion
Tipo de dados: cadeia de caracteres
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: matriz de cadeia de caracteres
Aplica-se a: propriedades
Conjunto de valores que indicam quais privilégios do sistema devem estar disponíveis e habilitados para uma operação de gravação bem-sucedida.
Comentários
Códigos de localidade
Um código de localidade é do formulário "MS_<D de linguagem> de três dígitos". Por exemplo, a localidade em inglês é MS_409. A tabela a seguir lista as IDs de idioma.
| Idioma | ID de idioma (hexadecimal) |
|---|---|
| Árabe | 401 |
| Português (Brasil) | 416 |
| Chinês (Simplificado) | 804 |
| Chinês (Tradicional) | 404 |
| Tcheco | 405 |
| Dinamarquês | 406 |
| Holandês | 413 |
| Inglês (padrão) | 409 |
| Finlandês | 40b |
| Francês | 40c |
| Alemão | 407 |
| Grego | 408 |
| Hebraico | 40d |
| Húngaro | 40e |
| Italiano | 410 |
| Japonês | 411 |
| Coreano | 412 |
| Norueguês | 414 |
| Polonês | 415 |
| Português (Portugal) | 816 |
| Russo | 419 |
| Espanhol | c0a |
| Sueco | 41D |
| Turco | 41f |
Usando o Qualificador de Bypass_GetObject
Usar o qualificador de Bypass_GetObject em um método pode produzir resultados confusos.
O exemplo a seguir define as classes Forma e Círculo . 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 de DrawIt. No entanto, se você usar o qualificador Bypass_GetObject no DrawIt, o WMI não chamará GetObject, não descobrirá que "Shape.Name='MyCircle"" é um Círculo e executará a implementação de Forma do DrawIt em vez da implementação circle de DrawIt.
A chamada a seguir para ExecMethod sempre invoca a implementação correta do DrawIt.
ExecMethod("Circle.Name='MyCircle'","DrawIt");
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |