Método IWbemContext::GetValue (wbemcli.h)

  • Artigo

O método IWbemContext::GetValue é usado para recuperar um valor de contexto nomeado específico por nome.

Sintaxe

HRESULT GetValue(
  [in]  LPCWSTR wszName,
  [in]  long    lFlags,
  [out] VARIANT *pValue
);

Parâmetros

[in] wszName

Nome para o qual o valor deve ser recuperado. Isso deve apontar para um BSTR válido. O ponteiro é tratado como somente leitura.

[in] lFlags

Reservado. Esse parâmetro deve ser 0.

[out] pValue

Esse parâmetro não pode ser NULL e deve apontar para um VARIANT não inicializado. Se nenhum erro for retornado, o VARIANT será inicializado usando VariantInit e definido para conter o valor de contexto. O chamador deve chamar VariantClear nesse ponteiro quando o valor não for mais necessário. Se um código de erro for retornado, a VARIANT apontada por pValue será deixada sem modificações.

É possível que um objeto IWbemClassObject inteiro possa ser retornado dentro da VARIANT. Se esse for o caso, VT_UNKNOWN será o tipo VARIANT . O chamador pode pegar o ponteiro IUnknown e executar QueryInterface para obter o ponteiro IWbemClassObject .

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho wbemcli.h (inclua Wbemidl.h)
Biblioteca Wbemuuid.lib
DLL Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll

Confira também

IWbemContext

IWbemContext::SetValue