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