IEnumWiaItem：：Next 方法 (wia_xp.h)

IEnumWiaItem：：Next 方法填充指向 IWiaItem 接口的指针数组。

语法

HRESULT Next(
  [in]      ULONG    celt,
  [out]     IWiaItem **ppIWiaItem,
  [in, out] ULONG    *pceltFetched
);

参数

[in] celt

类型： ULONG

指定 由 ppIWiaItem 参数指示的数组中的数组元素数。

[out] ppIWiaItem

类型： IWiaItem**

接收 IWiaItem 接口指针数组的地址。 IEnumWiaItem：：Next 使用接口指针填充此数组。

[in, out] pceltFetched

类型： ULONG*

输出时，此参数接收 实际存储在 ppIWiaItem 参数指示的数组中的接口指针数。 枚举完成后，此参数将包含零。

返回值

类型： HRESULT

如果该方法成功，该方法将返回S_OK。 枚举完成后，它将返回S_FALSE。 如果方法失败，它将返回标准 COM 错误代码。

注解

Windows 映像采集 (WIA) 运行时系统将 WIA 硬件设备表示为 IWiaItem 对象的分层树。 应用程序使用 IEnumWiaItem：：Next 方法获取硬件设备的 IWiaItem 对象树当前文件夹中每个项的 IWiaItem 接口指针。

为了获取指针列表，应用程序传递它分配的 IWiaItem 接口指针数组。 它还传递 celt 参数中的数组元素数。 IEnumWiaItem：：Next 方法使用指向 IWiaItem 接口的指针填充数组。

在枚举过程完成之前， IEnumWiaItem：：Next 方法返回S_OK。 每次这样做时，它都会将 pceltFetched 指向的值设置为它插入到数组中的项数。 当 IEnumWiaItem：：Next 完成枚举 IWiaItem 对象的过程时，它将返回S_FALSE并将 pceltFetched 指向的 内存位置设置为零。

应用程序必须在通过 ppIWiaItem 参数接收的接口指针上调用 IUnknown：：Release 方法。

要求