Share via

IWbemContext：：Next 方法 (wbemcli.h)

  • 项目

IWbemContext：：Next 方法检索以 IWbemContext：：BeginEnumeration 开头的所有上下文值的枚举中的下一个值。

语法

HRESULT Next(
  [in]  long    lFlags,
  [out] BSTR    *pstrName,
  [out] VARIANT *pValue
);

参数

[in] lFlags

保留。 此参数必须为 0。

[out] pstrName

此参数不能为 NULL。 指针不得指向条目上的活动 BSTR ，理想情况下，它应设置为指向 NULL。 如果未返回错误代码，则将其设置为指向包含上下文值名称的新分配 的 BSTR 。

当不再需要时，调用方必须对返回的字符串调用 SysFreeString 。 如果 WBEM_S_NO_MORE_DATA 返回， 则 pstrName 设置为指向 NULL，在这种情况下，不应调用 SysFreeString 。 请注意，如果 pstrName 指向条目上的有效 BSTR ，则不会释放此 BSTR ，并且会发生内存泄漏。

[out] pValue

此参数不能为 NULL，它必须指向空或未初始化的 VARIANT。 如果未返回错误，则使用 VariantInit 初始化 VARIANT，然后设置为包含上下文值。 当不再需要值时，调用方必须对此指针调用 VariantClear 。 如果返回错误代码，则 pValue 指向的 VARIANT 保持不变。

如果WBEM_S_NO_MORE_DATA返回，则此参数设置为指向 VT_NULL 类型的 VARIANT。

可能会在 VARIANT 内返回整个 IWbemClassObject 对象。 如果是这种情况，则 VT_UNKNOWN 为 VARIANT 类型。 调用方可以获取 IUnknown 指针并执行 QueryInterface 以获取 IWbemClassObject 指针。

注意 在枚举结束时，返回 WBEM_S_NO_MORE_DATA 。 返回的 VARIANT 类型为 VT_NULL，返回的 pstrName 为 NULL。
 

返回值

此方法返回指示方法调用状态的 HRESULT。 以下列表列出了 HRESULT 中包含的值。

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 wbemcli.h (包括 Wbemidl.h)
Library Wbemuuid.lib
DLL Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Wbemcomn.dll;Wbemcore.dll;Wbemess.dll;Wmipjobj.dll

另请参阅

IWbemContext

IWbemContext：：BeginEnumeration

IWbemContext：：EndEnumeration