Bagikan melalui


Membuat Rutinitas Panggilan Balik Antrean Kustom

Selain menggunakan panggilan balik antrean default, Anda dapat menulis rutinitas panggilan balik kustom. Fungsi ini harus memiliki formulir yang sama dengan FileCallback. Ini berguna jika Anda memerlukan rutinitas panggilan balik untuk menangani pemberitahuan dengan cara selain yang disediakan oleh rutinitas panggilan balik antrean default.

Jika hanya sebagian kecil dari perilaku rutinitas panggilan balik antrean default yang perlu diubah, Anda dapat membuat rutinitas panggilan balik kustom untuk memfilter pemberitahuan, menangani hanya yang memerlukan perilaku khusus dan memanggil SetupDefaultQueueCallback untuk yang lain.

Misalnya, jika Anda ingin menangani kesalahan penghapusan file kustom, Anda dapat membuat fungsi panggilan balik kustom, MyCallback. Fungsi ini akan mencegat dan memproses SPFILENOTIFY_DELETEERROR pemberitahuan, dan memanggil fungsi panggilan balik antrean default untuk semua pemberitahuan lainnya. MyCallback mengembalikan nilai untuk pemberitahuan kesalahan penghapusan. Untuk semua pemberitahuan lainnya, MyCallback meneruskan nilai apa pun yang rutinitas panggilan balik antrean default yang dikembalikan ke antrean.

Alur kontrol ini diilustrasikan dalam diagram berikut.

panah dan kotak memperlihatkan aliran data untuk fungsi panggilan balik kustom

Penting

Jika fungsi panggilan balik kustom memanggil rutinitas panggilan balik antrean default, fungsi tersebut harus meneruskan penunjuk kekosongan yang dikembalikan oleh SetupInitDefaultQueueCallback atau SetupInitDefaultQueueCallbackEx ke rutinitas panggilan balik default.