IEnumMoniker：：Next 方法 (objidl.h)

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

语法

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

[in] celt

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

[out] rgelt

枚举项的数组。

枚举器负责调用 AddRef，调用方负责通过枚举的每个指针调用 Release 。如果 celt 大于 1，则调用方还必须传递传递给 pceltFetched 的非 NULL 指针，以了解要释放的指针数。

[in, out] pceltFetched

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

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