QualifierSet_BeginEnumeration 函数

将对象限定符的枚举器重置到枚举的起始处。

注意

此 API 仅供内部使用。不应从开发人员代码中使用。

语法

HRESULT QualifierSet_BeginEnumeration (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags
);

vFunc
[in] 未使用此参数。

ptr
[in] 指向 IWbemQualifierSet 实例的指针。

lFlags
[in] 注解部分中描述的标志或值的按位组合，该组合指定枚举中包含的限定符。

此函数返回的以下值是在 WbemCli.h 头文件中定义的，你也可以在代码中将这些值定义为常数：

常数	Value	说明
`WBEM_E_INVALID_PARAMETER`	0x80041008	`lFlags` 参数无效。
`WBEM_E_UNEXPECTED`	0x8004101d	对 `QualifierSet_BeginEnumeration` 的第二次调用是在没有对 `QualifierSet_EndEnumeration` 的干预调用的情况下进行。
`WBEM_E_OUT_OF_MEMORY`	0x80041006	内存不足，无法开始新的枚举。
`WBEM_S_NO_ERROR`	0	函数调用成功。

此函数包装对 IWbemQualifierSet::BeginEnumeration 方法的调用。

若要枚举对象的所有限定符，必须在首次调用 QualifierSet_Next 之前调用此方法。针对给定枚举保证限定符的枚举顺序是固定的。

可以作为 lEnumFlags 参数传递的标志在 WbemCli.h 头文件中定义，也可以在代码中将这些标志定义为常数。

返回的常量	Value	说明
	0	返回所有限定符的名称。
`WBEM_FLAG_LOCAL_ONLY`	0x10	仅返回特定于当前属性或对象的限定符的名称。对于属性：仅返回特定于属性的限定符（包括替代），而不是从类定义传播的限定符。对于实例：仅返回特定于实例的限定符名称。对于类：仅返回特定于要派生的类的限定符。
`WBEM_FLAG_PROPAGATED_ONLY`	0x20	仅返回从另一个对象传播的限定符的名称。对于属性：仅返回从类定义传播到此属性的限定符，而不是来自此属性本身的限定符。对于实例：仅返回从类定义传播的限定符。对于类：仅返回从父类继承的限定符名称。

平台：请参阅系统要求。

标头：WMINet_Utils.idl

.NET Framework 版本：自 4.7.2 起可用