检索枚举中的下一个限定符,该枚举以调用 QualifierSet_BeginEnumeration 函数开始。
注意
此 API 仅供内部使用。 不应从开发人员代码中使用。
语法
HRESULT QualifierSet_Next (
[in] int vFunc,
[in] IWbemQualifierSet* ptr,
[in] LONG lFlags,
[out] BSTR* pstrName,
[out] VARIANT* pVal,
[out] LONG* plFlavor
);
参数
vFunc [in] 未使用此参数。
ptr [in] 指向 IWbemQualifierSet 实例的指针。
lFlags [in] 保留。 此参数必须为 0。
pstrName [out] 限定符的名称。 如果为 null,则忽略此参数;否则,pstrName 不应指向有效的 BSTR,否则会发生内存泄漏。 如果不为 null,则函数在返回 WBEM_S_NO_ERROR 时将始终分配一个新的 BSTR。
pVal [out] 如果成功,则为限定符的值。 如果该函数失败,则不会修改 pVal 指向的 VARIANT。 如果此参数为 null,则忽略参数。
plFlavor [out] 指向接收限定符风格的 LONG 的指针。 如果不需要风格信息,则此参数可以为 null。
返回值
此函数返回的以下值是在 WbemCli.h 头文件中定义的,你也可以在代码中将这些值定义为常数:
| 常数 | Value | 说明 |
|---|---|---|
WBEM_E_INVALID_PARAMETER |
0x80041008 | 参数无效。 |
WBEM_E_UNEXPECTED |
0x8004101d | 调用方没有调用 QualifierSet_BeginEnumeration。 |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | 内存不足,无法开始新的枚举。 |
WBEM_S_NO_MORE_DATA |
0x40005 | 枚举中没有剩余限定符。 |
WBEM_S_NO_ERROR |
0 | 函数调用成功。 |
注解
此函数包装对 IWbemQualifierSet::Next 方法的调用。
重复调用 QualifierSet_Next 函数以枚举所有限定符,直到函数返回 WBEM_S_NO_MORE_DATA。 要提前终止枚举,请调用 QualifierSet_EndEnumeration 函数。
枚举期间返回的限定符的顺序未定义。
要求
平台:请参阅系统要求。
标头:WMINet_Utils.idl
.NET Framework 版本:自 4.7.2 起可用