描述
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。 |