Compartilhar via

Função QualifierSet_Put

  • Artigo

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

Esta API é somente para uso interno. Ela não é destinada 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 está em uso.

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

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

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

lFlavor
[in] Uma das constantes a seguir que define os tipos de qualificadores desejados para esse qualificador. O valor padrão é WBEM_FLAVOR_OVERRIDABLE (0).

Constante Valor Descrição
WBEM_FLAVOR_OVERRIDABLE 0 O qualificador não pode ser substituído em uma instância ou uma classe derivada. Este é 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 as classes derivadas.
WBEM_FLAVOR_NOT_OVERRIDABLE 0x10 O qualificador não pode ser substituído em uma instância ou classe derivada.
WBEM_FLAVOR_AMENDED 0x80 O qualificador é localizado.

Valor retornado

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 Valor Descrição
WBEM_E_CANNOT_BE_KEY 0x8004101f Houve uma tentativa inválida de especificar o qualificador Key em uma propriedade que não pode ser uma chave. As chaves são especificadas na definição de classe para 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 parâmetro pVal não é de um tipo de qualificador válido.
WBEM_E_OVERRIDE_NOT_ALLOWED 0x8004101a Não é possível chamar o método QualifierSet_Put 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.

Comentários

Essa função encapsula uma chamada ao método IWbemQualifierSet::Put.

Requisitos

Plataformas: confira Requisitos do sistema.

Header: WMINet_Utils.idl

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

Confira também