IWbemClassObject：：Next 方法 (wbemcli.h)

项目
08/27/2023

IWbemClassObject：：Next 方法检索以 IWbemClassObject：：BeginEnumeration 开头的枚举中的 next 属性。应重复调用以枚举所有属性，直到 WBEM_S_NO_MORE_DATA 返回。如果要提前终止枚举，则应调用 IWbemClassObject：：EndEnumeration 。

未定义枚举期间返回的属性的顺序。

语法

HRESULT Next(
  [in]            long    lFlags,
  [out]           BSTR    *strName,
  [out]           VARIANT *pVal,
  [out, optional] CIMTYPE *pType,
  [out, optional] long    *plFlavor
);

参数

[in] lFlags

保留。此参数必须为 0。

[out] strName

接收包含属性名称的新 BSTR 。若要防止客户端进程中的内存泄漏，调用方必须在不再需要名称时调用 SysFreeString 。如果名称不是必需的，可以将此参数设置为 NULL 。

[out] pVal

此 VARIANT 用属性的值填充。方法对此 VARIANT 调用 VariantInit，因此调用方应确保在调用之前 VARIANT 未处于活动状态。当不再需要值时，调用方必须使用 VariantClear 。

如果值不是必需的，可以将此参数设置为 NULL 。如果返回错误代码，则 pVal 指向的 VARIANT 保持不变。

[out, optional] pType

此参数可以为 NULL。如果它不是 NULL，它必须指向一个 CIMTYPE 变量， (放置属性类型的 LONG) 。此属性的值可能是 VT_NULLVARIANT，在这种情况下，需要确定该属性的实际类型。

[out, optional] plFlavor

可以为 NULL。如果不是 NULL，则指向的 LONG 值接收有关属性来源的信息，如下所示。有关详细信息，请参阅限定符风格和 WBEM_FLAVOR_TYPE。

WBEM_FLAVOR_ORIGIN_SYSTEM

属性是标准系统属性。

对于类：

WBEM_FLAVOR_ORIGIN_PROPAGATED

属性继承自父类。

属性虽然继承自父类，但尚未在实例级别进行修改。

WBEM_FLAVOR_ORIGIN_LOCAL

属性属于派生最多的类。

属性在实例级别修改 (，即提供值或已添加/修改) 限定符。

对于实例：

返回值

此方法返回指示方法调用状态的 HRESULT。以下列表列出了 HRESULT 中包含的值。有关常规 HRESULT 值，请参阅系统错误代码。

注解

如果属性的基础类型是对象路径、日期或时间或其他特殊类型，则返回的类型不包含足够的信息。调用方必须检查指定属性的 CIMTYPE ，并确定该属性是对象引用、日期或时间还是另一种特殊类型。

此方法还返回系统属性。

要求


最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	wbemcli.h (包括 Wbemidl.h)
Library	WbemUuid.lib
DLL	CIMWin32.dll;Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll;Wbemess.dll;Wmipiprt.dll