Fungsi GetJobs

Artikel
06/12/2023

Fungsi GetJob mengambil informasi tentang pekerjaan cetak tertentu.

Sintaks

BOOL GetJob(
  _In_  HANDLE  hPrinter,
  _In_  DWORD   JobId,
  _In_  DWORD   Level,
  _Out_ LPBYTE  pJob,
  _In_  DWORD   cbBuf,
  _Out_ LPDWORD pcbNeeded
);

Parameter

hPrinter [in]

Handel ke printer tempat data tugas cetak diambil. Gunakan fungsi OpenPrinter atau AddPrinter untuk mengambil handel printer.

JobId [in]

Mengidentifikasi pekerjaan cetak untuk mengambil data. Gunakan fungsi AddJob atau fungsi StartDoc untuk mendapatkan pengidentifikasi pekerjaan cetak.

Level [in]

Jenis informasi yang dikembalikan dalam buffer pJob . Jika Level adalah 1, pJob menerima struktur JOB_INFO_1 . Jika Level adalah 2, pJob menerima struktur JOB_INFO_2 .

pJob [out]

Penunjuk ke buffer yang menerima JOB_INFO_1 atau struktur JOB_INFO_2 yang berisi informasi tentang pekerjaan. Buffer harus cukup besar untuk menyimpan string yang diacu oleh anggota struktur.

Untuk menentukan ukuran buffer yang diperlukan, panggil GetJob dengan cbBuf diatur ke nol. GetJob gagal, GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER, dan parameter pcbNeeded mengembalikan ukuran, dalam byte, dari buffer yang diperlukan untuk menyimpan array struktur dan datanya.

cbBuf [in]

Ukuran, dalam byte, dari array.

pcbNeeded [out]

Penunjuk ke nilai yang menentukan jumlah byte yang disalin jika fungsi berhasil atau jumlah byte yang diperlukan jika cbBuf terlalu kecil.

Mengembalikan 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.

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	Winspool.drv
Nama Unicode dan ANSI	GetJobW (Unicode) dan GetJobA (ANSI)

Lihat juga

Pencetakan
Cetak Fungsi API Spooler
TambahkanPekerjaan
JOB_INFO_1
JOB_INFO_2
ScheduleJob
SetJob

Bagikan melalui