IEnumParticipant::Next 方法

[下一步 不适用于 Windows Vista、Windows Server 2008 和操作系统的后续版本。 RTC 客户端 API 提供类似的功能。]

Next 方法获取枚举序列中下一个指定数量的元素。 此方法对 Visual Basic 和脚本语言隐藏。

语法

HRESULT Next(
  [in]  ULONG         celt,
  [out] ITParticipant **ppElements,
  [out] ULONG         *pceltFetched
);

参数

celt [in]

请求的元素数。

ppElements [out]

指向 ITAgentHandler 接口的 指针。

pceltFetched [out]

指向实际提供的元素数的指针。 如果 celt 为 1,则可能为 NULL

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
方法返回的元素数为 celt
S_FALSE
剩余的元素数小于 celt
E_POINTER
ppElements 参数不是有效的指针。
E_OUTOFMEMORY
内存不足,无法执行操作。

备注

TAPI 在 IEnumParticipant::Next 返回的 ITAgentHandler 接口上调用 AddRef 方法。 应用程序必须在 ITAgentHandler 接口上调用 Release,以释放与其关联的资源。

要求

要求
TAPI 版本
需要 TAPI 3.0 或更高版本
标头
Confpriv.h

Uuid.lib
DLL
Tapi3.dll

另请参阅

IEnumParticipant

ITParticipant