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