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 |