Função Get

Artigo
05/09/2023

Recupera o valor da propriedade especificado, caso exista.

Observação

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

Sintaxe

HRESULT Get (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LPCWSTR           wszName,
   [in] LONG              lFlags,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Parâmetros

vFunc
[in] Esse parâmetro não está em uso.

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

wszName
[in] O nome da propriedade.

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

pVal
[out] Se a função retornar com êxito, conterá o valor da propriedade wszName. O argumento pval recebe o tipo e o valor corretos para o qualificador.

pvtType
[out] Se a função retornar com êxito, conterá uma constante do tipo CIM que indica o tipo de propriedade. Seu valor também pode ser null.

plFlavor
[out] Se a função retornar com êxito, receberá informações sobre a origem da propriedade. Seu valor pode ser null, ou uma das seguintes constantes de WBEM_FLAVOR_TYPE definidas no arquivo de cabeçalho WbemCli.h:

Constante	Valor	Descrição
`WBEM_FLAVOR_ORIGIN_SYSTEM`	0x40	A propriedade é uma propriedade padrão do sistema.
`WBEM_FLAVOR_ORIGIN_PROPAGATED`	0x20	Para uma classe: a propriedade é herdada da classe pai. Para uma instância: a propriedade, embora herdada da classe pai, não foi modificada pela instância.
`WBEM_FLAVOR_ORIGIN_LOCAL`	0	Para uma classe: a propriedade pertence à classe derivada. Para uma instância: a propriedade é modificada pela instância; ou seja, um valor foi fornecido ou um qualificador foi adicionado ou modificado.

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_FAILED`	0x80041001	Houve uma falha geral.
`WBEM_E_INVALID_PARAMETER`	0x80041008	Um ou mais dos parâmetros não são válidos.
`WBEM_E_NOT_FOUND`	0x80041002	A propriedade especificada não foi encontrada.
`WBEM_E_OUT_OF_MEMORY`	0x80041006	Não há memória disponível suficiente para concluir a operação.
`WBEM_S_NO_ERROR`	0	A chamada de função foi bem-sucedida.

Comentários

Essa função encapsula uma chamada para o método IWbemClassObject::Get.

A função Get também pode retornar propriedades do sistema.

O argumento pVal recebe o tipo e o valor corretos para o qualificador e a função VariantInit do COM

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