IEnumAgent::Next 方法 (tapi3.h)
Next 方法获取枚举序列中下一个指定数量的元素。
语法
HRESULT Next(
[in] ULONG celt,
[out] ITAgent **ppElements,
[out] ULONG *pceltFetched
);
参数
[in] celt
请求的元素数。
[out] ppElements
指向 ITAgent 指针的 指针。
[out] pceltFetched
指向实际提供的元素数的指针。 如果 celt 为 1,则可能为 NULL。
返回值
此方法可以返回其中一个值。
值 | 含义 |
---|---|
|
方法返回的元素数为 celt 。 |
|
剩余的元素数小于 celt。 |
|
ppElements 参数不是有效的指针。 |
|
内存不足,无法执行操作。 |
注解
TAPI 在 IEnumAgent::Next 返回的 ITAgent 接口上调用 AddRef 方法。 应用程序必须在 ITAgent 接口上调用 Release,以释放与其关联的资源。
要求
目标平台 | Windows |
标头 | tapi3.h (包括 Tapi3.h) |
Library | Uuid.lib |
DLL | Tapi3.dll |