描述
IWbemQualifierSet.Next方法在以IWbemQualifierSet.BeginEnumeration开头的枚举中检索下一个限定符。重复调用此方法以枚举所有限定符,直到WBEM_S_NO_MORE_DATA返回。要提前终止枚举,请调用IWbemQualifierSet.EndEnumeration.
枚举期间返回的限定符的顺序未定义。
C++ 语法
HRESULT Next( [in] LONG lFlags, [out] BSTR *pstrName, [out] VARIANT *pVal, [out] LONG *plFlavor ); |
PowerBASIC 语法
METHOD Next ( _ BYVAL lFlags AS LONG, _ BYREF pstrName AS WSTRING, _ BYREF pVal AS VARIANT, _ BYREF plFlavor AS LONG _ ) AS LONG |
参数
lFlags
保留。该参数必须为0。
pstrName
此参数接收限定符的名称。始终在WBEM_S_NO_ERROR返回时分配新的BSTR.
如果pstrName为NULL,则会被忽略;否则,调用者必须确保该参数不会指向有效的BSTR,否则会出现内存泄漏。
pVal
此参数接收限定符的值。VariantInit通过此方法在VARIANT上调用。如果返回错误代码,PVAL指向的VARIANT未修改。如果设置为NULL,则忽略此参数。
plFlavor
如果不为NULL,则指向的值被设置为限定符。有关详细信息,请参阅限定口味.
返回值
此方法返回一个HRESULT,指示方法调用的状态。下表列出了HRESULT中包含的值。
退货代码 |
描述 |
WBEM_E_INVALID_PARAMETER |
指定了无效参数。 |
WBEM_E_OUT_OF_MEMORY |
没有足够的内存来完成操作。 |
WBEM_E_UNEXPECTED |
来电者没有打电话给IWbemQualifierSet.BeginEnumeration. |
WBEM_S_NO_ERROR |
通话成功。 |
WBEM_S_NO_MORE_DATA |
枚举中没有更多的限定词。 |
要求
客户 |
需要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 |
需要Fastprox.dll。 需要Krnlprov.dll。 需要Ncprov.dll。 需要Wbemcore.dll。 |