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

如果 pstrNameNULL,则忽略它;否则,调用方必须确保此参数不指向条目上的有效 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

IWbemQualifierSet::EndEnumeration

限定符风格