IEnumProgressItems::Next 方法 (imapi2fs.h)
检索枚举序列中指定数目的项。
语法
HRESULT Next(
[in] ULONG celt,
[out] IProgressItem **rgelt,
[out] ULONG *pceltFetched
);
参数
[in] celt
要检索的项数。
[out] rgelt
IProgressItem 接口的数组。 完成后,必须在 rgelt 中释放每个接口。
[out] pceltFetched
rgelt 中返回的元素数。 如果 celt 为 1,则可以将 pceltFetched 设置为 NULL。 否则,请在调用此方法之前将 pceltFetched 的值初始化为 0。
返回值
如果成功返回请求的元素数 (celt) ,或者 (pceltFetched) 返回的项数小于请求的元素数,则返回S_OK。
其他成功代码可能会作为实现的结果返回。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:
返回代码 | 说明 |
---|---|
|
指针无效。
值:0x80004003 |
|
未能分配所需的内存。
值:0x8007000E |
|
一个或多个参数无效。
值:0x80070057 |
注解
如果序列中剩余的元素数少于请求的元素数,它将检索剩余的元素。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista、Windows XP SP2 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | imapi2fs.h |