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