Obter função

Artigo
04/11/2023

Obtém o valor da propriedade especificada, se existir.

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 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] Este parâmetro não é utilizado.

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

wszName
[in] O nome da propriedade .

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

pVal
[fora] Se a função devolver com êxito, contém o valor da wszName propriedade . É pval atribuído ao argumento o tipo e o valor corretos para o qualificador.

pvtType
[fora] Se a função devolver com êxito, contém uma constante do tipo CIM que indica o tipo de propriedade. O respetivo valor também pode ser null.

plFlavor
[fora] Se a função devolver com êxito, receberá informações sobre a origem da propriedade. O respetivo valor pode ser nullou uma das seguintes WBEM_FLAVOR_TYPE constantes definidas no ficheiro de cabeçalho WbemCli.h :

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

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_FAILED`	0x80041001	Houve uma falha geral.
`WBEM_E_INVALID_PARAMETER`	0x80041008	Um ou mais 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 existe memória suficiente disponível para concluir a operação.
`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 IWbemClassObject::Get .

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

É pVal atribuído ao argumento o tipo e valor corretos para o qualificador e a função VARIANTE COMInit

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

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

Partilhar via