描述
IWbemContext.SetValue方法创建或覆盖指定的上下文值。
C++ 语法
HRESULT SetValue( [in] LPCWSTR strName, [in] LONG lFlags, [in] VARIANT *pValue ); |
PowerBASIC 语法
METHOD SetValue ( _ BYREF strName AS WSTRINGZ, _ BYVAL lFlags AS LONG, _ BYREF pValue AS VARIANT _ ) AS LONG |
参数
strName
不能为空。它是一个只读指针，指示上下文值名称。此值必须为空终止。
lFlags
保留。该参数必须为0（零）。
pValue
必须指向一个有效的VARIANT，它被视为只读。VARIANT中的值将成为命名的上下文值。整个IWbemClassObject对象可以通过将其包含在使用VT_UNKNOWN类型的VARIANT中来存储和简单的值。主叫方必须通过请求IID_IUnknown并使用VARIANT中返回的指针来执行IWbemClassObject对象上的QueryInterface.
如果p值要包含嵌入式IWbemClassObject对象，则调用者必须调用IWbemClassObject.QueryInterface为IID_IUnknown，并将结果指针放在VARIANT中，使用一种类型的VT_UNKNOWN。原始嵌入对象在写入操作期间被复制，因此不能被操作修改。
返回值
此方法返回一个HRESULT，指示方法调用的状态。下表列出了HRESULT中包含的值。
退货代码 |
描述 |
WBEM_E_INVALID_PARAMETER |
指定了无效参数。 |
WBEM_E_OUT_OF_MEMORY |
没有足够的内存来完成操作。 |
WBEM_E_FAILED |
有一般的失败。 |
WBEM_S_NO_ERROR |
通话成功。 |
要求
客户 |
需要Windows Vista，Windows XP，Windows 2000 Professional，Windows NT Workstation 4.0 SP4及更高版本，Windows Me，Windows 98或Windows 95。 |
服务器 |
需要Windows Server 2008，Windows Server 2003，Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。 |
头 |
在Wbemcli.inc中声明。 |
DLL |
需要Esscli.dll。 需要Fastprox.dll。 需要Framedyn.dll。 需要Wbemcomn.dll。 需要Wbemcore.dll。 需要Wbemess.dll。 需要Wmipjobj.dll。 |