Next 方法

描述

IWbemClassObject.Next方法检索以IWbemClassObject.BeginEnumeration开头的枚举中的下一个属性。应该重复调用此值来枚举所有属性，直到WBEM_S_NO_MORE_DATA返回。如果枚举要提前终止，则应该调用IWbemClassObject.EndEnumeration.

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

C++ 语法

HRESULT Next(

[in] LONG lFlags,

[out] BSTR *pstrName,

[out] VARIANT *pVal,

[out, optional] CIMTYPE *pvtType,

[out, optional] LONG *plFlavor

);

PowerBASIC 语法

METHOD Next ( _

BYVAL lFlags AS LONG, _

BYREF pstrName AS WSTRING, _

BYREF pVal AS VARIANT, _

BYREF pvtType AS LONG, _

BYREF plFlavor AS LONG _

) AS LONG

参数

lFlags

保留。该参数必须为0。

pstrName

接收包含属性名称的新BSTR.如果不需要该名称，可以将此参数设置为NULL。

pVal

此VARIANT填充了该属性的值。该方法在此VARIANT上调用VariantInit，因此呼叫方应确保VARIANT在通话之前未处于活动状态。

如果不需要该值，可以将此参数设置为NULL。如果返回错误代码，则PVAL指向的VARIANT未修改。

pvtType

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

plFlavor

可以为NULL。如果不为NULL，则指向的LONG值将收到关于属性的来源的信息如下：

WBEM_FLAVOR_ORIGIN_SYSTEM

该属性是一个标准的系统属性。

课程：

WBEM_FLAVOR_ORIGIN_PROPAGATED

该属性从父类继承。

WBEM_FLAVOR_ORIGIN_LOCAL

该属性属于派生最多的类。

对于实例：

WBEM_FLAVOR_ORIGIN_PROPAGATED

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

WBEM_FLAVOR_ORIGIN_LOCAL

属性在实例级别进行修改（即，已提供值或添加/修改限定符）。

返回值

此方法返回一个HRESULT，指示方法调用的状态。下表列出了HRESULT中包含的值。

退货代码	描述
WBEM_E_FAILED	发生未指定的错误。
WBEM_E_INVALID_PARAMETER	指定了无效参数。
WBEM_E_OUT_OF_MEMORY	没有足够的内存来完成操作。
WBEM_E_UNEXPECTED	未调用IWbemClassObject.BeginEnumeration.
WBEM_S_NO_ERROR	呼叫成功。
WBEM_S_NO_MORE_DATA	枚举中不再有其他属性。
WBEM_E_TRANSPORT_FAILURE	这表示当前进程和Windows Management之间的远程过程调用（RPC）链接失败。

备注

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

此方法也返回系统属性。

要求

客户	需要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	需要Cimwin32.dll。需要Esscli.dll。需要Evntrprv.dll。需要Fastprox.dll。需要Framedyn.dll。需要Krnlprov.dll。需要Ncprov.dll。需要Wbemcore.dll。需要Wbemess.dll。需要Wmipiprt.dll。