勇芳软件工作室.汉化:  Windows Management Instrumentation > COM API for WMI > Interfaces > IWbemQualifierSet >

Next Method

Previous pageReturn to chapter overviewNext page

描述

 

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。