Partilhar via

QualifierSet_Put função

Escreve o qualificador nomeado e o valor. O novo qualificador sobrepõe o valor anterior do mesmo nome. Se o qualificador não existir, é criado.

Observação

Esta API é apenas para uso interno. Não é destinado a ser usado em código de desenvolvedor.

Sintaxe

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

Parâmetros

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

ptr
[dentro] Um apontador para uma instância do IWbemQualifierSet .

wszName
[dentro] O nome do qualificador a escrever.

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

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

Constante Valor Description
WBEM_FLAVOR_OVERRIDABLE 0 O qualificador pode ser sobreposto numa classe ou instância derivada. Este é o valor padrão.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE 1 O qualificador é propagado para as 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 anulado numa classe ou instância derivada.
WBEM_FLAVOR_AMENDED 0x80 O qualificador é localizado.

Valor de retorno

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 Description
WBEM_E_CANNOT_BE_KEY 0x8004101f Houve uma tentativa ilegal de especificar o Key qualificador 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 é do tipo qualificativo 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 sobrescrições.
WBEM_S_NO_ERROR 0 A chamada de função foi bem-sucedida.

Observações

Esta função envolve uma chamada ao método IWbemQualifierSet::P ut .

Requerimentos

Plataformas: Consulte Requisitos do sistema.

Cabeçalho: WMINet_Utils.idl

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

Consulte também

  • Last updated on