IEnumWIA_DEV_INFO::Next 方法 (wia_xp.h)

IEnumWIA_DEV_INFO::Next 方法填充指向 IWiaPropertyStorage 接口的指针数组。

语法

HRESULT Next(
  [in]      ULONG               celt,
  [out]     IWiaPropertyStorage **rgelt,
  [in, out] ULONG               *pceltFetched
);

参数

[in] celt

类型: ULONG

指定 rgelt 参数指示的数组中的数组元素数。

[out] rgelt

类型: IWiaPropertyStorage**

接收 IWiaPropertyStorage 接口指针数组的地址。 IEnumWIA_DEV_INFO::Next 用接口指针填充此数组。

[in, out] pceltFetched

类型: ULONG*

在输出时,此参数包含实际存储在 rgelt 参数指示的数组中的接口指针数。

返回值

类型: HRESULT

尽管还有要枚举的设备,但此方法返回S_OK。 枚举完成后,它将返回S_FALSE。 如果方法失败,则返回标准 COM 错误代码。

注解

应用程序使用此方法查询每个可用的 Windows 映像采集 (WIA) 硬件设备的属性。 为此,应用程序会传递它分配的 IWiaPropertyStorage 接口指针数组。 它还传递参数 celt 中的数组元素数。 IEnumWIA_DEV_INFO::Next 方法使用指向 IWiaPropertyStorage 接口的指针填充数组。 应用程序可以查询接口以获取设备支持的属性。

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

要求

要求
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 wia_xp.h (包括 Wia.h)
Library Wiaguid.lib