IEnumLocation::Next 方法 (tapi3if.h)

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

语法

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

参数

[in] celt

请求的元素数。

[out] ppElements

指向 ITLocationInfo 指针的 指针。

[out] pceltFetched

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

返回值

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

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

注解

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

要求

要求
目标平台 Windows
标头 tapi3if.h (包括 Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll