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 |