Função QualifierSet_Get

Artigo
05/10/2023

Obtém o qualificador nomeado especificado.

Observação

Esta API é somente para uso interno. Ela não é destinada ao uso do código do desenvolvedor.

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] Esse parâmetro não está em uso.

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

wszName [in] O nome do qualificador cujo valor é solicitado.

lFlags [in] Reservado. Esse parâmetro deve ser 0.

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

plFlavor [out] Um ponteiro para um LONG que recebe os bits do tipo de qualificador para o qualificador solicitado. Se as informações de tipo não forem desejadas, esse parâmetro poderá ser null.

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_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 bem-sucedida.

Comentários

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

Requisitos

Plataformas: confira Requisitos do sistema.

Header: WMINet_Utils.idl

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

Confira também

WMI e Contadores de Desempenho (Referência de API Não Gerenciada)

Compartilhar via