描述
IWbemContext.GetValue方法用于通过名称检索特定的命名上下文值。
C++ 语法
HRESULT GetValue( [in] LPCWSTR strName, [in] LONG lFlags, [out] VARIANT *pValue ); |
PowerBASIC 语法
METHOD GetValue ( _ BYREF strName AS WSTRINGZ, _ BYVAL lFlags AS LONG, _ BYREF pValue AS VARIANT _ ) AS LONG |
参数
strName
要检索该值的名称。这必须指向一个有效的以null结尾的unicode字符串。指针被视为只读。
lFlags
保留。该参数必须为0。
pValue
此参数不能为NULL，必须指向未初始化的VARIANT.如果没有返回错误，VARIANT将使用VariantInit初始化，然后设置为包含上下文值。如果返回错误代码，p值指向的VARIANT未修改。
可以在VARIANT内部返回整个IWbemClassObject对象。如果是这样，则VT_UNKNOWN是VARIANT类型。主叫方可以使用IUnknown指针并执行QueryInterface以获取IWbemClassObject指针。
返回值
此方法返回一个HRESULT，指示方法调用的状态。下表列出了HRESULT中包含的值。
退货代码 |
描述 |
WBEM_E_NOT_FOUND |
找不到请求的值。 |
WBEM_E_INVALID_PARAMETER |
指定了无效参数。 |
WBEM_E_OUT_OF_MEMORY |
没有足够的内存来完成操作。 |
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。 |