IEnumFsiItems::Next 方法 (imapi2fs.h)

检索枚举序列中指定数目的项。

语法

HRESULT Next(
  [in]  ULONG    celt,
  [out] IFsiItem **rgelt,
  [out] ULONG    *pceltFetched
);

参数

[in] celt

要检索的项数。

[out] rgelt

IFsiItem 接口的数组。 完成后,必须在 rgelt 中释放每个接口。

[out] pceltFetched

rgelt 中返回的元素数。 如果 celt 为一个,则可以将 pceltFetched 设置为 NULL。 否则,在调用此方法之前,将 pceltFetched 的值初始化为 0。

返回值

如果成功返回请求的元素数 (celt) ,或者 (pceltFetched) 返回的项数小于请求的元素数,则返回S_OK。

由于实现,可能会返回其他成功代码。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:

返回代码 说明
E_POINTER
指针无效。

值:0x80004003

E_OUTOFMEMORY
未能分配所需的内存。

值:0x8007000E

E_INVALIDARG
一个或多个参数无效。

值:0x80070057

注解

如果序列中剩余的元素数少于请求的元素数,它将检索剩余的元素。

要求

要求
最低受支持的客户端 Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imapi2fs.h

另请参阅

IEnumFsiItems

IEnumFsiItems::RemoteNext