Método IWbemContext::SetValue (wbemcli.h)
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 |