IEnumFORMATETC::Next 方法 (objidl.h)

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

语法

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

参数

[in] celt

要检索的项数。 如果序列中剩余的项数少于请求的项数,此方法将检索剩余的元素。

[out] rgelt

枚举项的数组。

枚举器负责分配任何内存,调用方负责释放内存。 如果 celt 大于 1,则调用方还必须传递传递给 pceltFetched 的非 NULL 指针,以了解要释放的指针数。

[in, out] pceltFetched

检索到的项数。 此参数始终小于或等于请求的项数。 如果 celt 为 1,此参数可以为 NULL

返回值

如果方法检索请求的项数,则返回值S_OK。 否则,S_FALSE。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 objidl.h

另请参阅

FORMATETC

IEnumFORMATETC