Método IWbemQualifierSet::P ut (wbemcli.h)
O método IWbemQualifierSet::P ut grava o qualificador e o valor nomeados. O novo qualificador substitui o valor anterior do mesmo nome. Se o qualificador não existir, ele será criado.
Às vezes, não é possível gravar o valor de um qualificador, por exemplo, se o qualificador for propagado de outro objeto. Normalmente, os qualificadores propagados são somente leitura, mas podem ser substituídos. Para obter mais informações, consulte Variantes qualificadoras.
Ao usar o Qualificador de chave, não é necessário especificar nenhum tipo ou regras de propagação.
O usuário pode não criar qualificadores com nomes que começam ou terminam com um sublinhado (_). Isso é reservado para propriedades e classes de sistema.
Sintaxe
HRESULT Put(
[in] LPCWSTR wszName,
[in] VARIANT *pVal,
[in] long lFlavor
);
Parâmetros
[in] wszName
Nome do qualificador que está sendo gravado. O ponteiro é tratado como somente leitura.
[in] pVal
Não pode ser NULL. Isso deve apontar para uma VARIANT válida que contém o valor do qualificador a ser gravado. O ponteiro é tratado como somente leitura. É responsabilidade do chamador chamar VariantClear nesse ponteiro depois que o valor não for necessário.
Há suporte apenas para variantes e matrizes do tipo VT_I4, VT_R8, VT_BSTRVT_BOOL .
[in] lFlavor
Tipos de qualificador desejados para este qualificador. A lista a seguir lista as constantes apropriadas para lFlavor. O valor padrão é zero (0).
WBEM_FLAVOR_OVERRIDABLE (0 (0x0))
O valor do qualificador pode ser substituído em uma classe derivada ou em uma instância. Esse é o padrão. Usar essa constante é o mesmo que usar o sinalizador EnableOverride .
WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE (1 (0x1))
O qualificador é propagado para instâncias. Usar essa constante é o mesmo que usar o sinalizador ToInstance .
WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS (2 (0x2))
O qualificador é propagado para as classes derivadas. Usar essa constante é o mesmo que usar o sinalizador ToSubClass .
WBEM_FLAVOR_NOT_OVERRIDABLE (16 (0x10))
O valor do qualificador não pode ser substituído em uma classe derivada ou em uma instância. Usar essa constante é o mesmo que usar o sinalizador DisableOverride .
WBEM_FLAVOR_AMENDED (128 (0x80))
O qualificador é localizado. Usar essa constante é o mesmo que usar o sinalizador alterado .
Retornar valor
Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | wbemcli.h (inclua Wbemidl.h) |
| Biblioteca | Wbemuuid.lib |
| DLL | Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll |