Bagikan melalui


Tentang Rutinitas Panggilan Balik Antrean Default

Rutinitas panggilan balik antrean default menangani pemberitahuan yang dikirim oleh SetupCommitFileQueue secara generik. Dengan menggunakan rutinitas default, Anda mendapatkan antarmuka pengguna siap pakai untuk membuat kotak dialog penyiapan umum. Disarankan agar Anda menggunakan rutinitas panggilan balik antrean default, baik untuk kemudahan penggunaan, maupun untuk memastikan tampilan dan perilaku kotak dialog yang konsisten yang dihasilkan selama penginstalan.

Rutinitas panggilan balik default memerlukan struktur konteks untuk penyimpanan rekaman internal. Selain itu, antrean meneruskan informasi tambahan yang relevan dengan pemberitahuan saat ini melalui serangkaian parameter, Param1 dan Param2.

Misalnya, jika antrean mengirim pemberitahuan SPFILENOTIFY_NEEDMEDIA ke fungsi callback default, Param1 menunjuk ke struktur SOURCE_MEDIA yang berisi informasi mengenai media yang dibutuhkan, dan Param2 menunjuk ke array karakter yang dapat menerima informasi jalur baru dari pengguna.

Rutinitas panggilan balik default menggunakan informasi ini untuk meminta pengguna menyisipkan media sumber yang diperlukan, menentukan jalur baru, melewati penyalinan file saat ini, atau membatalkan operasi saat ini. Rutinitas panggilan balik antrean default mengembalikan FILEOP_NEWPATH, FILEOP_DOIT , FILEOP_SKIP, atau FILEOP_ABORT ke antrean, tergantung pada tindakan mana yang diambil pengguna.

Untuk informasi tentang bagaimana rutin panggilan balik antrean bawaan menangani setiap pemberitahuan antrean, lihat Pemberitahuan Antrean File .

Untuk informasi tentang rutinitas panggilan balik antrean kustom, lihat Membuat Rutinitas Panggilan Balik Antrean Kustom.