Metode IWiaItem2::CreateChildItem

Buat item anak baru. Menambahkan objek IWiaItem2 ke pohon IWiaItem2 perangkat.

Sintaks

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

Parameter

lItemFlags [in]

Jenis: LONG

Menentukan jenis item WIA 2.0. Lihat Bendera Tipe Item WIA.

lCreationFlags [in]

Jenis: LONG

Menentukan cara membuat item baru.

0 (0)

Atur nilai default untuk properti anak.

COPY_PARENT_PROPERTY_VALUES (0x40000000)

Salin nilai semua properti Baca/Tulis dari induk.

bstrItemName [in]

Jenis: BSTR

Menentukan nama item. Nama ini ditambahkan ke akhir nama item induk untuk menghasilkan nama item lengkap.

ppIWiaItem2 [out]

Jenis: IWiaItem2**

Menerima alamat pointer ke antarmuka IWiaItem2 yang mengatur metode IWiaItem2::CreateChildItem .

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Beberapa perangkat keras WIA 2.0 memungkinkan aplikasi untuk membuat item baru di pohon IWiaItem2 yang mewakili perangkat. Aplikasi harus menguji perangkat untuk melihat apakah mereka mendukung kemampuan ini. Gunakan antarmuka IEnumWIA_DEV_CAPS untuk menghitung kemampuan perangkat saat ini.

Jika perangkat mengizinkan pembuatan item baru di pohon IWiaItem2 , memanggil IWiaItem2::CreateChildItem membuat objek IWiaItem2 baru yang merupakan anak dari simpul saat ini. Ini meneruskan pointer ke simpul baru ke aplikasi melalui parameter ppIWiaItem2 . Aplikasi harus memanggil metode IUnknown::Release pada pointer antarmuka yang mereka terima melalui parameter ppIWiaItem2 .

Jika lCreationFlags COPY_PARENT_PROPERTY_VALUES dan lItemFlags adalah nol, fungsi akan mengembalikan E_INVALIDARG.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	Wia.h
IDL	Wia.idl