描述
IWbemClassObject.BeginEnumeration方法将枚举的枚举重新枚举回到枚举的开头。在第一次调用IWbemClassObject.Next之前，调用者必须调用此方法来枚举对象上的所有属性。对于给定的IWbemClassObject实例，枚举属性的顺序被保证是不变的。
C++ 语法
HRESULT BeginEnumeration( [in] LONG lEnumFlags ); |
PowerBASIC 语法
METHOD BeginEnumeration ( _ BYVAL lEnumFlags AS LONG _ ) AS LONG |
参数
lEnumFlags
备注中描述的标志的组合。
返回值
此方法返回一个HRESULT，指示方法调用的状态。下表列出了HRESULT中包含的值。
退货代码 |
描述 |
WBEM_E_INVALID_PARAMETER |
指定的标志组合无效或指定了无效参数。 |
WBEM_E_UNEXPECTED |
第二次电话是IWbemClassObject.BeginEnumeration，而没有中断电话IWbemClassObject.EndEnumeration. |
WBEM_E_OUT_OF_MEMORY |
没有足够的内存开始新的枚举。 |
WBEM_S_NO_ERROR |
通话成功。 |
备注
您可以通过指定以下标志的组合来控制枚举中包含的属性。您可以将每个组中的一个标志与来自任何其他组的任何标志组合。但是，同一组的标志是相互排斥的。
GROUP 1
WBEM_FLAG_KEYS_ONLY
只包括构成关键的属性。
WBEM_FLAG_REFS_ONLY
只包括作为对象引用的属性。
GROUP 2
WBEM_FLAG_SYSTEM_ONLY
仅限于枚举系统属性。
WBEM_FLAG_NONSYSTEM_ONLY
从枚举中排除系统属性。包括本地和传播的属性。
课程：
WBEM_FLAG_CLASS_OVERRIDES_ONLY
仅限课程只有返回的属性是在类定义中被覆盖的属性。覆盖的属性是在基类中定义的属性，但具有默认值集或在当前类中定义的限定符。
WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES
仅限课程如果指定了此标志，枚举属性将是当前类定义中覆盖的属性（如WBEM_FLAG_CLASS_OVERRIDES_ONLY中）以及当前类定义中定义的新属性。
WBEM_MASK_CLASS_CONDITION
仅限课程不是标志 - 这只是一个应用于flags变量的掩码，以检查是否设置了WBEM_FLAG_CLASS_OVERRIDES_ONLY或WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES。
WBEM_FLAG_LOCAL_ONLY
仅限课程只包括在类本身中定义或修改的属性。
WBEM_FLAG_PROPAGATED_ONLY
仅限课程只包括从父类继承的属性。
对于实例：
WBEM_FLAG_LOCAL_ONLY
仅适用于实例。只包括实例中覆盖的属性。
WBEM_FLAG_PROPAGATED_ONLY
仅适用于实例。只包括从父类继承但不被覆盖的属性（即，值或限定符尚未更改）。
要求
客户 |
需要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。 |