IEnumFullIDList：：Next 方法 (shobjidl_core.h)

检索指定数量的IDLIST_ABSOLUTE项。

语法

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

[in] celt

类型： ULONG

rgelt 参数引用的数组中引用的项数。

[out] rgelt

类型： PIDLIST_ABSOLUTE*

成功时，包含 PIDL 数组。实现必须使用 CoTaskMemAlloc 分配这些项目标识符。调用应用程序负责使用 CoTaskMemFree 释放项标识符。

[out] pceltFetched

类型： ULONG*

成功时，包含指向一个值的指针，该值接收 rgelt 中实际返回的绝对项标识符的计数。计数可以小于 celt 参数中指定的值。仅当 celt 为 1 时，此参数才能在条目上为 NULL，因为在这种情况下，方法只能检索一个 (S_OK) 或零个 (S_FALSE) 项。

类型： HRESULT

如果方法成功检索了请求的 celt 元素，则返回S_OK。仅当成功检索请求的项的完整计数时，此方法才会返回S_OK。

S_FALSE指示请求的项多于枚举中保留的项数。 由 pceltFetched 参数指向的值指定检索到的实际项目数。请注意，如果没有其他要检索的项目，则该值将为 0。

否则返回 COM 定义的错误值。