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