Metodo IWbemContext::SetValue (wbemcli.h)

Il metodo IWbemContext::SetValue crea o sovrascrive un valore di contesto denominato.

Sintassi

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

Parametri

[in] wszName

Non può essere NULL. Si tratta di un puntatore di sola lettura che indica il nome del valore di contesto. Questo valore deve essere con terminazione Null.

[in] lFlags

Riservato. Questo parametro deve essere 0 (zero).

[in] pValue

Deve puntare a un valore VARIANT valido, considerato di sola lettura. Il valore in VARIANT diventa il valore di contesto denominato. Un intero oggetto IWbemClassObject può essere archiviato e un valore semplice racchiudendolo in un valore VARIANT che usa il tipo di VT_UNKNOWN . Il chiamante deve eseguire QueryInterface sull'oggetto IWbemClassObject richiedendo IID_IUnknown e utilizzando il puntatore restituito in VARIANT.

Se pValue deve contenere un oggetto IWbemClassObject incorporato, il chiamante deve chiamare IWbemClassObject::QueryInterface per IID_IUnknown e posizionare il puntatore risultante in VARIANT usando un tipo di VT_UNKNOWN. L'oggetto incorporato originale viene copiato durante l'operazione di scrittura e pertanto non può essere modificato dall'operazione.

Valore restituito

Questo metodo restituisce un valore HRESULT che indica lo stato di una chiamata al metodo. Nell'elenco seguente sono elencati e descritti i valori contenuti in un valore HRESULT.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008
Piattaforma di destinazione Windows
Intestazione wbemcli.h (include Wbemidl.h)
Libreria Wbemuuid.lib
DLL Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll

Vedi anche

IWbemContext

IWbemContext::GetValue