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 对象以及一个简单值。 调用方必须通过请求IID_IUnknown并使用 VARIANT 中返回的指针,对 IWbemClassObject 对象执行 QueryInterface

如果 pValue 包含嵌入的 IWbemClassObject 对象,则调用方必须为IID_IUnknown调用 IWbemClassObject::QueryInterface,并使用类型VT_UNKNOWN将生成的指针放在 VARIANT 中。 原始嵌入对象在写入操作期间复制,因此操作无法修改。

返回值

此方法返回指示方法调用状态的 HRESULT 。 以下列表列出并描述了 HRESULT 中包含的值。

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 wbemcli.h (包括 Wbemidl.h)
Library Wbemuuid.lib
DLL Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Wbemcomn.dll;Wbemcore.dll;Wbemess.dll;Wmipjobj.dll

另请参阅

IWbemContext

IWbemContext::GetValue