Partilhar via


função QualifierSet_Get

Obtém o qualificador com nome especificado.

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_Get (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LPCWSTR              wszName,
   [in] LONG                 lFlags,
   [out] VARIANT*            pVal,
   [out] LONG*               plFlavor
);

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 cujo valor é pedido.

lFlags [in] Reservado. Este parâmetro tem de ser 0.

pVal [fora] Quando for bem-sucedido, o tipo e o valor corretos para o qualificador. Se a função falhar, o VARIANT apontado por pVal não será modificado. Se este parâmetro for null, o parâmetro é ignorado.

plFlavor [fora] Um ponteiro para um LONG que recebe os bits de sabor de qualificação para o qualificador pedido. Se as informações de sabor não forem pretendidas, este parâmetro pode ser null.

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_INVALID_PARAMETER 0x80041008 Um parâmetro não é válido.
WBEM_E_NOT_FOUND 0x80041002 O qualificador especificado não existe.
WBEM_S_NO_ERROR 0 A chamada de função foi efetuada com êxito.

Observações

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

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: WMINet_Utils.idl

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

Ver também