Metode IWiaDevMgr::RegisterEventCallbackProgram (wia_xp.h)

Metode IWiaDevMgr::RegisterEventCallbackProgram mendaftarkan aplikasi untuk menerima peristiwa perangkat. Ini terutama disediakan untuk kompatibilitas mundur dengan aplikasi yang tidak ditulis untuk WIA.

Sintaks

HRESULT RegisterEventCallbackProgram(
  [in] LONG       lFlags,
  [in] BSTR       bstrDeviceID,
  [in] const GUID *pEventGUID,
  [in] BSTR       bstrCommandline,
  [in] BSTR       bstrName,
  [in] BSTR       bstrDescription,
  [in] BSTR       bstrIcon
);

Parameter

[in] lFlags

Jenis: LONG

Menentukan bendera pendaftaran. Dapat diatur ke nilai berikut:

Bendera Pendaftaran	Makna
WIA_REGISTER_EVENT_CALLBACK	Daftar untuk acara tersebut.
WIA_UNREGISTER_EVENT_CALLBACK	Hapus pendaftaran untuk peristiwa tersebut.
WIA_SET_DEFAULT_HANDLER	Atur aplikasi sebagai penanganan aktivitas default.

[in] bstrDeviceID

Jenis: BSTR

Menentukan pengidentifikasi perangkat. Teruskan NULL untuk mendaftar acara di semua perangkat WIA.

[in] pEventGUID

Jenis: const GUID*

Menentukan peristiwa tempat aplikasi mendaftar. Untuk daftar GUID peristiwa yang valid, lihat Pengidentifikasi Peristiwa WIA.

[in] bstrCommandline

Jenis: BSTR

Menentukan string yang berisi nama jalur lengkap dan argumen baris perintah yang sesuai yang diperlukan untuk memanggil aplikasi. Dua pasang tanda kutip harus digunakan, misalnya, ""C:\Program Files\MyExe.exe" /arg1".

[in] bstrName

Jenis: BSTR

Menentukan nama aplikasi. Nama ini ditampilkan kepada pengguna ketika beberapa aplikasi mendaftar untuk peristiwa yang sama.

[in] bstrDescription

Jenis: BSTR

Menentukan deskripsi aplikasi. Deskripsi ini ditampilkan kepada pengguna ketika beberapa aplikasi mendaftar untuk peristiwa yang sama.

[in] bstrIcon

Jenis: BSTR

Menentukan ikon yang mewakili aplikasi. Ikon ditampilkan kepada pengguna ketika beberapa aplikasi mendaftar untuk peristiwa yang sama. String berisi nama aplikasi dan indeks berbasis 0 ikon (mungkin ada lebih dari satu ikon yang mewakili aplikasi) yang dipisahkan oleh koma. Misalnya, "MyApp, 0".

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Gunakan IWiaDevMgr::RegisterEventCallbackProgram untuk mendaftar peristiwa perangkat keras jenis WIA_ACTION_EVENT. Ketika peristiwa terjadi di mana aplikasi terdaftar, aplikasi diluncurkan dan informasi peristiwa dikirimkan ke aplikasi.

Aplikasi menggunakan metode EnumRegisterEventInfo untuk mengambil pointer ke objek enumerator untuk properti pendaftaran peristiwa.

Aplikasi dapat menemukan apakah peristiwa adalah peristiwa jenis tindakan atau jenis pemberitahuan (atau keduanya) dengan memeriksa nilai ulFlags dari struktur WIA_DEV_CAP yang dikembalikan oleh enumerasi peristiwa.

Program hanya boleh menggunakan metode IWiaDevMgr::RegisterEventCallbackProgram untuk kompatibilitas mundur dengan aplikasi yang tidak ditulis untuk arsitektur WIA. Aplikasi baru harus menggunakan antarmuka Model Objek Komponen (COM) yang disediakan oleh arsitektur WIA. Secara khusus, mereka harus memanggil IWiaDevMgr::RegisterEventCallbackInterface atau IWiaDevMgr::RegisterEventCallbackCLSID untuk mendaftar peristiwa perangkat.

Biasanya, metode ini dipanggil oleh program penginstalan atau skrip. Program penginstalan atau skrip mendaftarkan aplikasi untuk menerima peristiwa perangkat WIA. Ketika peristiwa terjadi, aplikasi akan dimulai oleh sistem run-time WIA.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	wia_xp.h (termasuk Wia.h)
Pustaka	Wiaguid.lib
DLL	Wiaservc.dll