struktur JOB_INFO_1

Artikel
06/12/2023

Struktur JOB_INFO_1 menentukan informasi pekerjaan cetak seperti nilai pengidentifikasi pekerjaan, nama printer tempat pekerjaan ditampung, nama mesin yang membuat pekerjaan cetak, nama pengguna yang memiliki pekerjaan cetak, dan sebagainya.

Sintaks

typedef struct _JOB_INFO_1 {
  DWORD      JobId;
  LPTSTR     pPrinterName;
  LPTSTR     pMachineName;
  LPTSTR     pUserName;
  LPTSTR     pDocument;
  LPTSTR     pDatatype;
  LPTSTR     pStatus;
  DWORD      Status;
  DWORD      Priority;
  DWORD      Position;
  DWORD      TotalPages;
  DWORD      PagesPrinted;
  SYSTEMTIME Submitted;
} JOB_INFO_1, *PJOB_INFO_1;

Anggota

JobId

Pengidentifikasi pekerjaan.

pPrinterName

Penunjuk ke string yang dihentikan null yang menentukan nama printer tempat pekerjaan ditampung.

pMachineName

Penunjuk ke string yang dihentikan null yang menentukan nama komputer yang membuat pekerjaan cetak.

pUserName

Penunjuk ke string yang dihentikan null yang menentukan nama pengguna yang memiliki pekerjaan cetak.

pDocument

Penunjuk ke string yang dihentikan null yang menentukan nama pekerjaan cetak (misalnya, "MS-WORD: Review.doc").

pDatatype

Penunjuk ke string yang dihentikan null yang menentukan jenis data yang digunakan untuk merekam pekerjaan cetak.

pStatus

Penunjuk ke string yang dihentikan null yang menentukan status pekerjaan cetak. Anggota ini harus diperiksa sebelum Status dan, jika pStatusNULL, status ditentukan oleh konten anggota Status.

Status

Status pekerjaan. Nilai anggota ini bisa nol atau kombinasi dari satu atau beberapa nilai berikut. Nilai nol menunjukkan bahwa antrean cetak dijeda setelah dokumen selesai menampung.

Nilai	Makna
JOB_STATUS_BLOCKED_DEVQ	Pengandar tidak dapat mencetak pekerjaan.
JOB_STATUS_COMPLETE	Windows XP dan yang lebih baru: Pekerjaan dikirim ke pencetak, tetapi pekerjaan mungkin belum dicetak. Lihat Keterangan untuk informasi selengkapnya.
JOB_STATUS_DELETED	Pekerjaan telah dihapus.
JOB_STATUS_DELETING	Pekerjaan sedang dihapus.
JOB_STATUS_ERROR	Kesalahan dikaitkan dengan pekerjaan.
JOB_STATUS_OFFLINE	Printer sedang offline.
JOB_STATUS_PAPEROUT	Pencetak kehabisan kertas.
JOB_STATUS_PAUSED	Pekerjaan dijeda.
JOB_STATUS_PRINTED	Pekerjaan telah dicetak.
JOB_STATUS_PRINTING	Pekerjaan sedang mencetak.
JOB_STATUS_RESTART	Pekerjaan telah dimulai ulang.
JOB_STATUS_RETAINED	Windows Vista dan yang lebih baru: Pekerjaan telah dipertahankan dalam antrean cetak dan tidak dapat dihapus. Hal ini dapat disebabkan oleh hal-hal berikut: 1) Pekerjaan dipertahankan secara manual oleh panggilan ke SetJob dan penampung sedang menunggu pekerjaan dirilis. 2) Pekerjaan belum selesai mencetak dan harus menyelesaikan pencetakan sebelum dapat dihapus secara otomatis. Lihat SetJob untuk informasi selengkapnya tentang perintah tugas cetak.
JOB_STATUS_SPOOLING	Pekerjaan adalah spooling.
JOB_STATUS_USER_INTERVENTION	Printer memiliki kesalahan yang mengharuskan pengguna untuk melakukan sesuatu.

Prioritas

Prioritas pekerjaan. Anggota ini bisa menjadi salah satu nilai berikut atau dalam rentang antara 1 hingga 99 (MIN_PRIORITY hingga MAX_PRIORITY).

Nilai	Makna
MIN_PRIORITY	Prioritas minimum.
MAX_PRIORITY	Prioritas maksimum.
DEF_PRIORITY	Prioritas default.

Position

Posisi pekerjaan dalam antrean cetak.

TotalPages

Jumlah total halaman yang dimuat dokumen. Nilai ini mungkin nol jika pekerjaan cetak tidak berisi informasi pembatas halaman.

PagesPrinted

Jumlah halaman yang telah dicetak. Nilai ini mungkin nol jika pekerjaan cetak tidak berisi informasi pembatas halaman.

Dikumpulkan

Struktur SYSTEMTIME yang menentukan waktu dokumen ini ditampung.

Nilai waktu ini dalam format Universal Time Coordinate (UTC). Anda harus mengonversinya ke nilai waktu lokal sebelum menampilkannya. Anda dapat menggunakan fungsi FileTimeToLocalFileTime untuk melakukan konversi.

Keterangan

Monitor port yang tidak mendukung TrueEndOfJob akan mengatur pekerjaan sebagai JOB_STATUS_PRINTED tepat setelah pekerjaan dikirimkan ke printer.

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)
Nama Unicode dan ANSI	_JOB_INFO_1W (Unicode) dan _JOB_INFO_1A (ANSI)

Lihat juga

Pencetakan
Cetak Struktur API Spooler
EnumJobs
GetJobs
SetJob

Bagikan melalui