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 起可用

另请参阅