Get 函数
检索指定的属性值(如果存在)。
注意
此 API 仅供内部使用。 不应从开发人员代码中使用。
语法
HRESULT Get (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LPCWSTR wszName,
[in] LONG lFlags,
[out] VARIANT* pVal,
[out] CIMTYPE* pvtType,
[out] LONG* plFlavor
);
参数
vFunc
[in] 未使用此参数。
ptr
[in] 指向 IWbemClassObject 实例的指针。
wszName
[in] 属性的名称。
lFlags
[in] 保留。 此参数必须为 0。
pVal
[out] 如果函数成功返回,则包含 wszName
属性的值。 为 pval
参数分配了限定符的正确类型和值。
pvtType
[out] 如果函数成功返回,则包含指示属性类型的 CIM-type 常量。 其值也可以为 null
。
plFlavor
[out] 如果函数成功返回,则接收有关属性来源的信息。 其值可以为 null
,或 WbemCli.h 头文件中定义的以下 WBEM_FLAVOR_TYPE 常量之一:
返回的常量 | Value | 说明 |
---|---|---|
WBEM_FLAVOR_ORIGIN_SYSTEM |
0x40 | 属性是标准系统属性。 |
WBEM_FLAVOR_ORIGIN_PROPAGATED |
0x20 | 对于类:属性继承自父类。 对于实例:属性虽然继承自父类,但未被实例修改。 |
WBEM_FLAVOR_ORIGIN_LOCAL |
0 | 对于类:属性属于派生类。 对于实例:属性将被实例修改;即,会提供某个值,或添加或修改某个限定符。 |
返回值
此函数返回的以下值是在 WbemCli.h 头文件中定义的,你也可以在代码中将这些值定义为常数:
常数 | Value | 说明 |
---|---|---|
WBEM_E_FAILED |
0x80041001 | 发生一般性故障。 |
WBEM_E_INVALID_PARAMETER |
0x80041008 | 一个或多个参数无效。 |
WBEM_E_NOT_FOUND |
0x80041002 | 未找到指定的属性。 |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | 没有足够的可用内存来完成该操作。 |
WBEM_S_NO_ERROR |
0 | 函数调用成功。 |
注解
此函数包装对 IWbemClassObject::Get 方法的调用。
Get
函数还可以返回系统属性。
为 pVal
参数分配了限定符的正确类型和值以及 COM VariantInit 函数
要求
平台:请参阅系统要求。
标头:WMINet_Utils.idl
.NET Framework 版本:自 4.7.2 起可用