IEnumWiaItem2::Next 方法
填充指向 IWiaItem2 接口的指针数组。
语法
HRESULT Next(
[in] ULONG cElt,
[out] IWiaItem2 **ppIWiaItem2,
[in, out] ULONG *pcEltFetched
);
参数
-
cElt [in]
-
类型: ULONG
指定 由 ppIWiaItem2 参数指示的数组中的数组元素数。
-
ppIWiaItem2 [out]
-
类型: IWiaItem2**
接收 IWiaItem2 接口指针数组的地址。 IEnumWiaItem2::Next 使用接口指针填充此数组。
-
pcEltFetched [in, out]
-
类型: ULONG*
输出时,此参数接收实际存储在 ppIWiaItem2 参数指示的数组中的接口指针数。 枚举完成后,此参数包含零。
返回值
类型: HRESULT
如果此方法成功,则返回 S_OK。 否则,它将返回 HRESULT 错误代码。
备注
Windows 映像采集 (WIA) 2.0 运行时系统将 WIA 2.0 硬件设备表示为 IWiaItem2 对象的分层树。 应用程序使用 IEnumWiaItem2::Next 方法获取硬件设备的 IWiaItem2 对象树当前文件夹中每个项的 IWiaItem2 接口指针。
为了获取指针列表,应用程序传递它分配的 IWiaItem2 接口指针数组。 它还传递参数 cElt 中的数组元素数。 IEnumWiaItem2::Next 方法使用指向 IWiaItem2 接口的指针填充数组。
在枚举过程完成之前, IEnumWiaItem2::Next 方法返回S_OK。 每次这样做时,它都会将 pcEltFetched 指向的值设置为它插入到数组中的项数。 当 IEnumWiaItem2::Next 完成枚举 IWiaItem2 对象的过程时,它将返回S_FALSE并将 pcEltFetched 指向的 内存位置设置为零。
应用程序必须在通过 ppIWiaItem2 参数接收的接口指针上调用 IUnknown::Release 方法。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2008 [仅限桌面应用] |
标头 |
|
IDL |
|