Fungsi ScheduleJob

Artikel
06/13/2023

Fungsi ScheduleJob meminta agar penampung cetak menjadwalkan tugas cetak tertentu untuk pencetakan.

Sintaks

BOOL ScheduleJob(
  _In_ HANDLE hPrinter,
  _In_ DWORD  dwJobID
);

Parameter

hPrinter [in]

Handel ke pencetak untuk tugas cetak. Ini harus merupakan pencetak lokal yang dikonfigurasi sebagai pencetak yang tertampung. Jika hPrinter adalah handel ke koneksi printer jarak jauh, atau jika printer dikonfigurasi untuk pencetakan langsung, fungsi ScheduleJob gagal. Gunakan fungsi OpenPrinter atau AddPrinter untuk mengambil handel printer.

hPrinter harus memiliki handel printer yang sama yang ditentukan dalam panggilan ke AddJob yang memperoleh pengidentifikasi pekerjaan cetak dwJobID .

dwJobID [in]

Tugas cetak yang akan dijadwalkan. Anda mendapatkan pengidentifikasi pekerjaan cetak ini dengan memanggil fungsi AddJob .

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Catatan

Ini adalah fungsi pemblokiran atau sinkron dan mungkin tidak segera dikembalikan. Seberapa cepat fungsi ini kembali tergantung pada faktor run-time seperti status jaringan, konfigurasi server cetak, dan faktor implementasi driver printer yang sulit diprediksi saat menulis aplikasi. Memanggil fungsi ini dari utas yang mengelola interaksi dengan antarmuka pengguna dapat membuat aplikasi tampak tidak responsif.

Anda harus berhasil memanggil fungsi AddJob sebelum memanggil fungsi ScheduleJob . AddJob mendapatkan pengidentifikasi pekerjaan cetak yang Anda berikan ke ScheduleJob sebagai dwJobID. Kedua panggilan harus menggunakan nilai yang sama untuk hPrinter.

Fungsi ScheduleJob memeriksa file penampung yang valid. Jika ada file penampung yang tidak valid, atau jika kosong, ScheduleJob akan menghapus file penampung dan entri tugas cetak yang sesuai di penampung cetak.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Winspool.h (termasuk Windows.h)
Pustaka	Winspool.lib
DLL	Spoolss.dll

Lihat juga

Pencetakan
Cetak Fungsi API Spooler
TambahkanPekerjaan
OpenPrinter

Share via