IEnumOleUndoUnits：：Next 方法 (ocidl.h)

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

语法

HRESULT Next(
  [in]  ULONG        cElt,
  [out] IOleUndoUnit **rgElt,
  [out] ULONG        *pcEltFetched
);

[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