IEnumBstr::Next 方法 (tapi3if.h)

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

语法

HRESULT Next(
  [in]      ULONG celt,
  [out]     BSTR  *ppStrings,
  [in, out] ULONG *pceltFetched
);

参数

[in] celt

请求的元素数。

[out] ppStrings

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

[in, out] pceltFetched

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

返回值

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

返回代码 说明
S_OK
方法返回的元素数为 celt
S_FALSE
剩余的元素数小于 celt
E_POINTER
ppStrings 参数不是有效的指针。

注解

应用程序必须使用 SysFreeString 来释放为 ppStrings 参数分配的内存。

要求

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