IWiaItem2：：CreateChildItem 方法

  • 项目

创建新的子项。 将 IWiaItem2 对象添加到设备的 IWiaItem2 树。

语法

HRESULT CreateChildItem(
  [in]  LONG      lItemFlags,
  [in]  LONG      lCreationFlags,
  [in]  BSTR      bstrItemName,
  [out] IWiaItem2 **ppIWiaItem2
);

参数

lItemFlags [in]

类型： LONG

指定 WIA 2.0 项类型。 请参阅 WIA 项类型标志。

lCreationFlags [in]

类型： LONG

指定如何创建新项。

0 (0)

设置子级属性的默认值。

COPY_PARENT_PROPERTY_VALUES (0x40000000)

从父级复制所有读/写属性的值。

bstrItemName [in]

类型： BSTR

指定项名称。 此名称将追加到父项名称的末尾，以生成完整的项名称。

ppIWiaItem2 [out]

类型： IWiaItem2**

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

返回值

类型： HRESULT

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

备注

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

如果设备允许在 IWiaItem2 树中创建新项，则调用 IWiaItem2：：CreateChildItem 将创建一个新的 IWiaItem2 对象，该对象是当前节点的子级。 它通过 ppIWiaItem2 参数将指向新节点的指针传递给应用程序。 应用程序必须在通过 ppIWiaItem2 参数接收的接口指针上调用 IUnknown：：Release 方法。

如果 lCreationFlags 为COPY_PARENT_PROPERTY_VALUES且 lItemFlags 为零，则函数返回E_INVALIDARG。

要求

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