IWbemQualifierSet::Next 方法 (wbemcli.h)
IWbemQualifierSet::Next 方法检索以 IWbemQualifierSet::BeginEnumeration 开头的枚举中的下一个限定符。 重复调用此方法以枚举所有限定符,直到 WBEM_S_NO_MORE_DATA 返回。 若要提前终止枚举,请调用 IWbemQualifierSet::EndEnumeration。
未定义枚举期间返回的限定符的顺序。
语法
HRESULT Next(
[in] long lFlags,
[out] BSTR *pstrName,
[out] VARIANT *pVal,
[out] long *plFlavor
);
参数
[in] lFlags
保留。 此参数必须为 0 (零) 。
[out] pstrName
此参数接收限定符的名称。 每当WBEM_S_NO_ERROR返回时,始终分配新的 BSTR。
如果 pstrName 为 NULL,则忽略它;否则,调用方必须确保此参数不指向条目上的有效 BSTR ,否则会出现内存泄漏。 此外,调用方必须记住在不再需要返回的字符串时调用 SysFreeString 。
[out] pVal
此参数接收限定符的值。 通过此方法在 VARIANT 上调用 VariantInit。 当不再需要值时,调用方必须对此指针调用 VariantClear 。 如果返回错误代码,则 pVal 指向的 VARIANT 保持不变。 如果设置为 NULL,则忽略此参数。
[out] plFlavor
如果不是 NULL,则指向 的值将设置为限定符风格。 有关详细信息,请参阅 限定符风格 和 WBEM_FLAVOR_TYPE。
返回值
此方法返回指示方法调用状态的 HRESULT。 以下列表列出了 HRESULT 中包含的值。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | wbemcli.h (包括 Wbemidl.h) |
Library | Wbemuuid.lib |
DLL | Fastprox.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll |
另请参阅
IWbemQualifierSet::BeginEnumeration