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
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
如果至少检索到 IShellItem 接口,则为 。 |
|
如果枚举中没有更多 IShellItem 接口,则为 。 |
如果函数因任何其他原因而失败,则返回错误值。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |