IEnumOleUndoUnits::Next 方法 (ocidl.h)
检索枚举序列中指定数量的项。
语法
HRESULT Next(
[in] ULONG cElt,
[out] IOleUndoUnit **rgElt,
[out] ULONG *pcEltFetched
);
parameters
[in] cElt
要检索的项数。 如果序列中剩余的项数少于请求的项数,此方法将检索剩余的元素。
[out] rgElt
枚举项的数组。
枚举器负责调用 AddRef,调用方负责通过枚举的每个指针调用 Release 。 如果 cElt 大于 1,则调用方还必须传递传递给 pcEltFetched 的非 NULL 指针,以了解要释放的指针数。
[out] pcEltFetched
检索到的项数。 此参数始终小于或等于请求的项数。
返回值
如果方法检索请求的项数,则返回值S_OK。 否则,S_FALSE。
注解
此方法成功返回后,调用方负责为数组中的每个元素调用 Release 方法。 如果 cUndoUnits 大于 1,则调用方还必须将非 NULL 指针传递给 pcFetched 以获取它必须释放的指针数。
不允许将E_NOTIMPL作为返回值。 如果返回错误值,则 rgpcd 数组中没有任何条目在退出时有效,并且不需要释放。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | ocidl.h |