Compartilhar via


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

Confira também

Variantes de qualificador