IWiaItem：：CreateChildItem 方法 (wia_xp.h)

应用程序使用 IWiaItem：：CreateChildItem 方法将 IWiaItem 对象添加到设备的 IWiaItem 树中。

语法

HRESULT CreateChildItem(
  [in]  LONG     lFlags,
  [in]  BSTR     bstrItemName,
  [in]  BSTR     bstrFullItemName,
  [out] IWiaItem **ppIWiaItem
);

参数

[in] lFlags

类型： LONG

指定 WIA 项类型。 必须设置为 WIA 项类型标志中列出的值之一。

[in] bstrItemName

类型： BSTR

指定 WIA 项名称，例如“Top”。 可以将此参数视为等效于文件名。

[in] bstrFullItemName

类型： BSTR

指定完整的 WIA 项名称。 可以将此参数视为等效于文件的完整路径，例如“003\Root\Top”。

[out] ppIWiaItem

类型： IWiaItem**

接收指向 IWiaItem 接口的指针的地址，该接口设置 IWiaItem：：CreateChildItem 方法。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

某些 WIA 硬件设备允许应用程序在表示设备的 IWiaItem 树中创建新项。 应用程序必须测试设备以查看它们是否支持此功能。 使用 IEnumWIA_DEV_CAPS 接口枚举当前设备的功能。

如果设备允许在 IWiaItem 树中创建新项，则调用 IWiaItem：：CreateChildItem 会创建一个新的 IWiaItem，该 IWiaItem 是当前节点的子节点。 IWiaItem：：CreateChildItem 通过 ppIWiaItem 参数将指向新节点的指针传递给应用程序。

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

要求

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