IEnumPluggableTerminalClassInfo：：Next 方法 (tapi3if.h)

项目
03/02/2024

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

语法

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

参数

[in] celt

请求的元素数。

[out] ppElements

指向返回的指针的 ITPluggableTerminalClassInfo 列表的指针。

[in, out] pceltFetched

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

返回值

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

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

注解

TAPI 在 IEnumPluggableTerminalClassInfo：：Next 返回的 ITPluggableTerminalClassInfo 接口上调用 AddRef 方法。应用程序必须在 ITPluggableTerminalClassInfo 接口上调用 Release，以释放与之关联的资源。