Compartilhar via

função QualifierSet_Put

Grava o qualificador nomeado e o valor. O novo qualificador substitui o valor anterior do mesmo nome. Se o qualificador não existir, ele será criado.

Observação

Essa API é apenas para uso interno. Ele não se destina ao uso do código do desenvolvedor.

Sintaxe

HRESULT QualifierSet_Put (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LPCWSTR              wszName,
   [in] VARIANT*             pVal,
   [in] LONG                 lFlavor
);

Parâmetros

vFunc
[in] Esse parâmetro não é usado.

ptr
[in] Um ponteiro para uma instância IWbemQualifierSet .

wszName
[in] O nome do qualificador a ser gravado.

pVal
[in] Um ponteiro para um válido VARIANT que contém o qualificador a ser gravado. Esse parâmetro não pode ser null.

lFlavor
[in] Uma das seguintes constantes que define os sabores de qualificador desejados para este qualificador. O valor padrão é WBEM_FLAVOR_OVERRIDABLE (0).

Constante Value Description
WBEM_FLAVOR_OVERRIDABLE 0 O qualificador pode ser substituído em uma classe ou instância derivada. Esse é o valor padrão.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE 1 O qualificador é propagado para instâncias.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS 2 O qualificador é propagado para classes derivadas.
WBEM_FLAVOR_NOT_OVERRIDABLE 0x10 O qualificador não pode ser substituído em uma classe ou instância derivada.
WBEM_FLAVOR_AMENDED 0x80 O qualificador é localizado.

Valor de retorno

Os seguintes valores retornados por essa função são definidos no arquivo de cabeçalho WbemCli.h ou você pode defini-los como constantes em seu código:

Constante Value Description
WBEM_E_CANNOT_BE_KEY 0x8004101f Houve uma tentativa ilegal de especificar o Key qualificador em uma propriedade que não pode ser uma chave. As chaves são especificadas na definição de classe de um objeto e não podem ser alteradas por instância.
WBEM_E_INVALID_PARAMETER 0x80041008 Um parâmetro não é válido.
WBEM_E_INVALID_QUALIFIER_TYPE 0x80041029 O pVal parâmetro não é de um tipo qualificador legal.
WBEM_E_OVERRIDE_NOT_ALLOWED 0x8004101a Não é possível chamar o QualifierSet_Put método no qualificador porque o objeto proprietário não permite substituições.
WBEM_S_NO_ERROR 0 A chamada de função foi bem-sucedida.

Observações

Essa função encapsula uma chamada para o método IWbemQualifierSet::P ut .

Requirements

Plataformas: confira Requisitos do sistema.

Cabeçalho: WMINet_Utils.idl

Versões do .NET Framework: Disponível desde 4.7.2

Consulte também

  • Last updated on