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。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
方法返回的元素数为 celt 。 |
|
剩余的元素数小于 celt。 |
|
ppElements 参数不是有效的指针。 |
|
内存不足,无法执行操作。 |
备注
TAPI 在 IEnumParticipant::Next 返回的 ITAgentHandler 接口上调用 AddRef 方法。 应用程序必须在 ITAgentHandler 接口上调用 Release,以释放与其关联的资源。
要求
要求 | 值 |
---|---|
TAPI 版本 |
需要 TAPI 3.0 或更高版本 |
标头 |
|
库 |
|
DLL |
|