Fungsi ReplyPrinterChangeNotification (winsplp.h)

Artikel
02/27/2024

Fungsi ReplyPrinterChangeNotification penampung cetak memungkinkan penyedia cetak memperbarui database penampung peristiwa antrean cetak yang terkait dengan handel pemberitahuan, dan untuk memberi tahu klien bahwa peristiwa antrean cetak telah terjadi.

Sintaks

BOOL ReplyPrinterChangeNotification(
                  HANDLE hPrinter,
                  DWORD  fdwChangeFlags,
  [out, optional] PDWORD pdwResult,
  [in, optional]  PVOID  pPrinterNotifyInfo
);

Parameter

hPrinter

Handel yang disediakan penelepon. Handel ini sebelumnya harus diterima sebagai input hNotify ke fungsi FindFirstPrinterChangeNotification penyedia cetak.

fdwChangeFlags

Satu atau beberapa bendera yang disediakan penelepon PRINTER_CHANGE_, tercantum dalam deskripsi dokumentasi Microsoft Windows SDK tentang FindNextPrinterChangeNotification.

[out, optional] pdwResult

Pilihan. Jika tidak NULL, ia menerima bendera PRINTER_NOTIFY_INFO prefiks PRINTER_NOTIFY_INFO yang disediakan yang menunjukkan hasil pembaruan informasi yang disediakan.

[in, optional] pPrinterNotifyInfo

Pilihan. Alamat yang disediakan penelepon dari struktur PRINTER_NOTIFY_INFO (dijelaskan dalam dokumentasi Windows SDK). Dapat berupa NULL jika tidak ada informasi pemberitahuan baru yang ditambahkan.

Menampilkan nilai

Jika operasi berhasil, fungsi mengembalikan TRUE. Jika tidak, fungsi mengembalikan FALSE. Penelepon dapat memperoleh kode kesalahan dengan memanggil GetLastError.

Keterangan

Penyedia cetak yang tidak mendukung polling (lihat FindFirstPrinterChangeNotification) harus memberi tahu penampung terjadinya peristiwa apa pun yang diwakili oleh bendera awalan PRINTER_CHANGE_ yang diterima oleh fungsi FindFirstPrinterChangeNotification penyedia. Ketika suatu peristiwa terjadi, penyedia cetak dapat memanggil ReplyPrinterChangeNotification untuk memberi tahu penampung peristiwa dan untuk memberikan informasi yang terkait dengan peristiwa tersebut. Penampung melacak informasi peristiwa ini, untuk setiap handel pemberitahuan, dan mengirimkan informasi ke aplikasi ketika aplikasi memanggil FindNextPrinterChangeNotification (dijelaskan dalam dokumentasi Windows SDK).

Ketika penyedia cetak memanggil ReplyPrinterChangeNotification, penyedia cetak harus mengidentifikasi peristiwa yang telah terjadi dengan mengatur bendera awalan PRINTER_CHANGE_ di fwdFlags atau dengan menggunakan pPrinterNotifyInfo untuk mengembalikan struktur PRINTER_NOTIFY_INFO. (Gunakan bendera yang tercantum dalam deskripsi dokumentasi Windows SDK tentang FindNextPrinterChangeNotification--bukan bendera yang tercantum dalam deskripsi dokumentasi Windows SDK tentang FindFirstPrinterChangeNotification.)

Memanggil ReplyPrinterChangeNotification menyebabkan penampung memberi sinyal kepada aplikasi klien bahwa peristiwa antrean cetak telah terjadi. Ini terjadi bahkan jika penyedia menyediakan NULL untuk pPrinterNotifyInfo. Untuk memperbarui catatan penampung perubahan antrean cetak tanpa menyebabkan klien diberi tahu, gunakan PartialReplyPrinterChangeNotification. Adalah umum untuk memanggil PartialReplyPrinterChangeNotification beberapa kali untuk memperbarui database penampung, lalu memanggil ReplyPrinterChangeNotification untuk memberi tahu klien bahwa perubahan telah terjadi.

Untuk informasi tambahan, lihat Mendukung Pemberitahuan Perubahan Printer.