Fungsi OpenPrintProcessor (winsplp.h)

Artikel
02/27/2024

Fungsi prosesor OpenPrintProcessor cetak menyiapkan prosesor cetak untuk mencetak pekerjaan dan mengembalikan handel.

Sintaks

HANDLE OpenPrintProcessor(
  [in] LPWSTR                  pPrinterName,
  [in] PPRINTPROCESSOROPENDATA pPrintProcessorOpenData
);

Parameter

[in] pPrinterName

Penunjuk yang disediakan penelepon ke nama printer tempat prosesor cetak dibuka.

[in] pPrintProcessorOpenData

Penunjuk yang disediakan penelepon ke struktur PRINTPROCESSOROPENDATA .

Nilai kembali

Jika operasi berhasil, fungsi harus mengembalikan handel yang dapat digunakan sebagai argumen input untuk panggilan berikutnya ke PrintDocumentOnPrintProcessor, ControlPrintProcessor, dan ClosePrintProcessor. Jika operasi gagal, fungsi harus memanggil SetLastError untuk mengatur kode kesalahan, lalu mengembalikan NULL.

Keterangan

Prosesor cetak diperlukan untuk mengekspor OpenPrintProcessor fungsi. Penampung memanggil fungsi ketika pekerjaan cetak tersedia. Fungsi harus melakukan operasi inisialisasi yang diperlukan sebelum pekerjaan dapat diproses, berdasarkan jenis data pekerjaan.

Fungsi harus mengembalikan handel. Biasanya, handel adalah penunjuk ke struktur internal. Struktur harus berisi penunjuk ke nama printer dan penunjuk ke struktur DEVMODEW printer, yang keduanya diterima dalam struktur PRINTPROCESSOROPENDATA . Kedua pointer ini diperlukan oleh fungsi PrintDocumentOnPrintProcessor prosesor cetak, dan fungsi terakhir ini menerima handel sebagai input ketika penampung memanggilnya.