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 |