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 |
|