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