Partilhar via

função QualifierSet_Put

  • Artigo

Escreve o qualificador e o valor nomeados. O novo qualificador substitui o valor anterior do mesmo nome. Se o qualificador não existir, é criado.

Nota

Esta API destina-se apenas a utilização interna. Não se destina a ser utilizado a partir do código do programador.

Sintaxe

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

Parâmetros

vFunc
[in] Este parâmetro não é utilizado.

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

wszName
[in] O nome do qualificador a escrever.

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

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

Constante Valor Descrição
WBEM_FLAVOR_OVERRIDABLE 0 O qualificador pode ser substituído numa classe ou instância derivada. Este é o valor predefinido.
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 numa classe ou instância derivada.
WBEM_FLAVOR_AMENDED 0x80 O qualificador está localizado.

Valor devolvido

Os seguintes valores devolvidos por esta função são definidos no ficheiro de cabeçalho WbemCli.h ou pode defini-los como constantes no seu código:

Constante Valor Descrição
WBEM_E_CANNOT_BE_KEY 0x8004101f Houve uma tentativa ilegal de especificar o qualificador de chave numa 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 de 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 da função foi efetuada com êxito.

Observações

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

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: WMINet_Utils.idl

.NET Framework Versões: Disponível desde a versão 4.7.2

Ver também