Compartilhar via


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

O método IWbemContext::SetValue cria ou substitui um valor de contexto nomeado.

Sintaxe

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

Parâmetros

[in] wszName

Não pode ser NULL. É um ponteiro somente leitura que indica o nome do valor de contexto. Esse valor deve ser encerrado em nulo.

[in] lFlags

Reservado. Esse parâmetro deve ser 0 (zero).

[in] pValue

Deve apontar para uma VARIANT válida, que é tratada como somente leitura. O valor na VARIANT torna-se o valor de contexto nomeado. Um objeto IWbemClassObject inteiro pode ser armazenado, bem como um valor simples colocando-o em uma VARIANT que usa o tipo VT_UNKNOWN . O chamador deve executar QueryInterface no objeto IWbemClassObject solicitando IID_IUnknown e usando o ponteiro retornado na VARIANT.

Se pValue deve conter um objeto IWbemClassObject inserido, o chamador deverá chamar IWbemClassObject::QueryInterface para IID_IUnknown e colocar o ponteiro resultante na VARIANT usando um tipo de VT_UNKNOWN. O objeto original inserido é copiado durante a operação de gravação e, portanto, não pode ser modificado pela operação.

Retornar valor

Esse método retorna um HRESULT que indica o status de uma chamada de método. A lista a seguir lista e descreve os valores contidos em um HRESULT.

Requisitos

Requisito Valor
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::GetValue