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

  • Artículo

El método IWbemContext::SetValue crea o sobrescribe un valor de contexto con nombre.

Sintaxis

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

Parámetros

[in] wszName

No puede ser NULL. Es un puntero de solo lectura que indica el nombre del valor de contexto. Este valor debe terminar en null.

[in] lFlags

Reservado. Este parámetro debe ser 0 (cero).

[in] pValue

Debe apuntar a un valor VARIANT válido, que se trata como de solo lectura. El valor de VARIANT se convierte en el valor de contexto con nombre. Se puede almacenar un objeto IWbemClassObject completo, así como un valor simple al incluirlo en un variant que usa el tipo VT_UNKNOWN . El autor de la llamada debe ejecutar QueryInterface en el objeto IWbemClassObject solicitando IID_IUnknown y usando el puntero devuelto en variant.

Si pValue va a contener un objeto IWbemClassObject incrustado, el autor de la llamada debe llamar a IWbemClassObject::QueryInterface para IID_IUnknown y colocar el puntero resultante en variant mediante un tipo de VT_UNKNOWN. El objeto incrustado original se copia durante la operación de escritura, por lo que la operación no puede modificarse.

Valor devuelto

Este método devuelve un HRESULT que indica el estado de una llamada de método. En la lista siguiente se enumeran y describen los valores contenidos en un HRESULT.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado wbemcli.h (include Wbemidl.h)
Library Wbemuuid.lib
Archivo DLL Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll

Consulte también

IWbemContext

IWbemContext::GetValue