IWiaItem2::EnumChildItems 方法

创建枚举器对象,并将指向其 IEnumWiaItem2 接口的指针传回其 IEnumWiaItem2 接口,该接口包含 Windows 映像采集 (WIA) 2.0 设备的 IWiaItem2 树中的项目。

语法

HRESULT EnumChildItems(
  [in]  const GUID          *pCategoryGUID,
  [out]       IEnumWiaItem2 **ppIEnumWiaItem2
);

参数

pCategoryGUID [in]

类型: const GUID*

指定指向为其枚举子节点的类别的指针。 如果 为 NULL,则枚举所有子节点。

ppIEnumWiaItem2 [out]

类型: IEnumWiaItem2**

接收指向此方法创建的 IEnumWiaItem2 接口的指针的地址。

返回值

类型: HRESULT

如果此方法成功,则返回 S_OK。 否则,它将返回 HRESULT 错误代码。

备注

WIA 2.0 运行时系统将每个 WIA 2.0 硬件设备表示为 IWiaItem2 对象的分层树。 IWiaItem2::EnumChildItems 方法使应用程序能够枚举当前项目中的子项。 但是,它只能应用于文件夹的项目。

如果文件夹不为空,则包含 IWiaItem2 对象的子树。 IWiaItem2::EnumChildItems 方法枚举文件夹中包含的所有项目。 它将指向枚举器的指针存储在 ppIEnumWiaItem2 参数中。 应用程序使用枚举器指针执行对象的子项的枚举。

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

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2008 [仅限桌面应用]
标头
Wia.h
IDL
Wia.idl