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

BeginEnumeration Method

Previous pageReturn to chapter overviewNext page

描述

 

IWbemQualifierSet.BeginEnumeration方法在对象中列出所有限定词之前重置。要枚举对象上的所有限定符,必须先调用IWbemQualifierSet.Next之前调用此方法。对于给定的IWbemQualifierSet实例,枚举限定符的顺序被保证是不变的。

 

C++ 语法

 

HRESULT BeginEnumeration(

[in]  LONG lFlags

);

 

PowerBASIC 语法

 

METHOD BeginEnumeration ( _

BYVAL lFlags AS LONG _

) AS LONG

 

参数

 

lFlags

 

指定要包含在枚举中的限定符。它必须是以下常量之一。

 

内容

含义

0(零)

返回所有限定词的名称。

WBEM_FLAG_LOCAL_ONLY

仅返回特定于当前属性或对象的限定符的名称。如果当前限定符集合引用一个属性,则只返回特定于属性的限定符(包括覆盖),而不是从类定义传播的限定符。如果当前限定符集合引用一个实例,则只返回特定于实例的限定符名称。如果当前限定词集指的是一个类,则只返回特定于派生类的限定符。

WBEM_FLAG_PROPAGATED_ONLY

仅返回从另一个对象传播的限定词的名称。例如,如果当前限定符集引用一个属性,则只返回从类定义传播到此属性的限定符,而不是返回属性本身的限定符。如果当前限定词集指的是一个实例,则只返回从类定义传播的限定符。如果当前限定词集指的是一个类,则只返回从父类继承的限定词。

 

返回值

 

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

 

退货代码

描述

WBEM_E_INVALID_PARAMETER

LFLAGS参数无效。

WBEM_E_OUT_OF_MEMORY

没有足够的内存来完成操作。

WBEM_E_UNEXPECTED

第二次致电IWbemQualifierSet.BeginEnumeration,而不会间接致电IWbemQualifierSet.EndEnumeration.

WBEM_S_NO_ERROR

通话成功。

 

要求

 

客户

需要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。