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 [仅限桌面应用]
标头
Wia.h
IDL
Wia.idl