Baca dalam bahasa Inggris

Bagikan melalui

Pemberitahuan (API Penyiapan)

  • Artikel

Pemberitahuan adalah nilai yang dikirim fungsi penyiapan ke rutinitas panggilan balik untuk menentukan status atau peristiwa. Dua parameter, Param1 dan Param2, dikirim dengan pemberitahuan, dan berisi informasi tambahan yang relevan dengan pemberitahuan.

Rutinitas panggilan balik memproses pemberitahuan dan mengembalikan bilangan bulat yang tidak ditandatangani ke fungsi penyiapan. Bergantung pada fungsi penyiapan, Anda dapat menggunakan nilai ini untuk menentukan operasi atau pilihan pengguna, atau Anda dapat mengabaikannya.

Fungsi penyiapan mengirim pemberitahuan ke rutinitas panggilan balik menggunakan sintaks berikut.

MsgHandler(          //the specified callback routine
    Context,         //context used by the callback routine
    Notification,    //notification code
    Param1,          //additional notification information
    Param2           //additional notification information
);

Parameter Context adalah penunjuk ke variabel konteks atau struktur yang dapat digunakan rutinitas panggilan balik untuk menyimpan informasi yang harus bertahan di antara panggilan berikutnya ke rutinitas panggilan balik.

Karena rutinitas panggilan balik menentukan implementasi konteks, dan tidak pernah direferensikan atau diubah oleh fungsi penyiapan, konteks tidak didokumenkan dalam materi referensi untuk pesan pemberitahuan yang mengikuti.

Parameter Pemberitahuan menentukan nilai bilangan bulat yang tidak ditandatangani untuk peristiwa atau status yang menyebabkan fungsi penyiapan memanggil rutinitas panggilan balik.

param1 dan Param2 adalah parameter opsional yang dapat berisi informasi tambahan yang relevan dengan pemberitahuan. Parameter ini adalah bilangan bulat yang tidak ditandatangani. Jika Param1 atau Param2 mengembalikan informasi yang bukan bilangan bulat yang tidak ditandatangani, itu ditransmisikan ke bilangan bulat yang tidak ditandatangani dan harus diprakirakan ulang ke jenis data aslinya sebelum dapat digunakan oleh rutinitas panggilan balik.

Catatan

Pemberitahuan berikut mewakili setiap pemberitahuan yang digunakan oleh fungsi penyiapan. Fungsi individual menggunakan subset pemberitahuan ini. Dengan kata lain, tidak setiap pemberitahuan digunakan oleh setiap fungsi.

 

Pemberitahuan berikut digunakan oleh fungsi penyiapan.

Pemberitahuan Deskripsi
SPFILENOTIFY_COPYERROR Terjadi kesalahan selama operasi penyalinan file.
SPFILENOTIFY_DELETEERROR Terjadi kesalahan selama operasi penghapusan file.
SPFILENOTIFY_ENDCOPY Operasi penyalinan file telah berakhir.
SPFILENOTIFY_ENDDELETE Operasi penghapusan file telah berakhir.
SPFILENOTIFY_ENDQUEUE Antrean telah selesai dilakukan.
SPFILENOTIFY_ENDREGISTRATION Pendaftaran atau pembatasan registrasi file telah selesai.
SPFILENOTIFY_ENDRENAME Operasi ganti nama file telah berakhir.
SPFILENOTIFY_ENDSUBQUEUE Sub-antrean (salin, ganti nama, atau hapus) telah berakhir.
SPFILENOTIFY_FILEEXTRACTED File telah diekstrak dari kabinet.
SPFILENOTIFY_FILEINCABINET File ditemui di kabinet.
SPFILENOTIFY_FILEOPDELAYED File sedang digunakan, dan operasi saat ini telah tertunda hingga sistem di-boot ulang.
SPFILENOTIFY_LANGMISMATCH Bahasa operasi saat ini tidak cocok dengan bahasa sistem.
SPFILENOTIFY_NEEDMEDIA Media sumber baru diperlukan.
SPFILENOTIFY_NEEDNEWCABINET File saat ini dilanjutkan di kabinet berikutnya.
SPFILENOTIFY_QUEUESCAN Simpul dalam antrean file telah dipindai.
SPFILENOTIFY_QUEUESCAN_EX Simpul dalam antrean file telah dipindai.
SPFILENOTIFY_QUEUESCAN_SIGNERINFO Simpul dalam antrean file telah dipindai.
SPFILENOTIFY_RENAMEERROR Terjadi kesalahan selama operasi ganti nama file.
SPFILENOTIFY_STARTCOPY Operasi penyalinan file telah dimulai.
SPFILENOTIFY_STARTDELETE Operasi penghapusan file telah dimulai.
SPFILENOTIFY_STARTQUEUE Antrean sudah mulai dilakukan.
SPFILENOTIFY_STARTREGISTRATION Pendaftaran atau unregistrasi file telah dimulai.
SPFILENOTIFY_STARTRENAME Operasi ganti nama file telah dimulai.
SPFILENOTIFY_STARTSUBQUEUE Sub-antrean (salin, ganti nama, atau hapus) telah dimulai.
SPFILENOTIFY_TARGETEXISTS Salinan file yang ditentukan sudah ada pada target.
SPFILENOTIFY_TARGETNEWER Versi yang lebih baru dari file yang ditentukan ada pada target.