Share via


IWbemContext::SetValue 方法 (wbemcli.h)

IWbemContext::SetValue 方法會建立或覆寫具名內容值。

語法

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

參數

[in] wszName

不可以是 NULL。 它是指出內容值名稱的唯讀指標。 此值必須 以 Null 結束。

[in] lFlags

保留的。 此參數必須是 0 (零) 。

[in] pValue

必須指向有效的 VARIANT,這會被視為唯讀。 VARIANT 中的值會變成具名內容值。 您可以儲存整個 IWbemClassObject 物件,並以使用 VT_UNKNOWN 類型的 VARIANT 括住它來儲存簡單值。 呼叫端必須在 IWbemClassObject 物件上執行 QueryInterface,方法是要求IID_IUnknown,並在 VARIANT 中使用傳回的指標。

如果 pValue 是要包含內嵌的 IWbemClassObject 物件,則呼叫端必須呼叫 IWbemClassObject::QueryInterface 以進行IID_IUnknown,並使用 VT_UNKNOWN 類型將產生的指標放在 VARIANT 中。 原始內嵌物件會在寫入作業期間複製,因此無法由作業修改。

傳回值

這個方法會傳回 HRESULT ,指出方法呼叫的狀態。 下列清單列出並描述 HRESULT 中包含的值。

規格需求

需求
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 wbemcli.h (包含 Wbemidl.h)
程式庫 Wbemuuid.lib
Dll Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Wbemcomn.dll;Wbemcore.dll;Wbemess.dll;Wmipjobj.dll

另請參閱

IWbemContext

IWbemContext::GetValue