IEnumShellItems：：Next 方法 (shobjidl_core.h)

  • 项目

从枚举中获取一个或多个 IShellItem 接口的数组。

语法

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

参数

[in] celt

类型： ULONG

rgelt 参数引用的数组中的元素数。

[out] rgelt

类型： IShellItem**

指向接收枚举项的 IShellItem 接口的指针数组的地址。 调用应用程序负责通过调用 IUnknown：：Release 方法释放 IShellItem 接口。

[out] pceltFetched

类型： ULONG*

指向接收成功检索到的 IShellItem 接口数的值的指针。 计数可以小于 celt 参数中指定的值。 仅当 celt 为 1 时，此参数才能在条目上为 NULL，因为在这种情况下，方法只能检索一个项并返回S_OK，或者返回零项并返回S_FALSE。

返回值

类型： HRESULT

此方法可以返回其中一个值。

返回代码 说明
S_OK
 如果至少检索到 IShellItem 接口，则为 。
S_FALSE
 如果枚举中没有更多 IShellItem 接口，则为 。
如果函数因任何其他原因而失败，则返回错误值。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)

另请参阅

IEnumShellItems

IShellItem