struktur JOB_INFO_2

Artikel
06/12/2023

Struktur JOB_INFO_2 menjelaskan serangkaian nilai lengkap yang terkait dengan pekerjaan.

Sintaks

typedef struct _JOB_INFO_2 {
  DWORD                JobId;
  LPTSTR               pPrinterName;
  LPTSTR               pMachineName;
  LPTSTR               pUserName;
  LPTSTR               pDocument;
  LPTSTR               pNotifyName;
  LPTSTR               pDatatype;
  LPTSTR               pPrintProcessor;
  LPTSTR               pParameters;
  LPTSTR               pDriverName;
  LPDEVMODE            pDevMode;
  LPTSTR               pStatus;
  PSECURITY_DESCRIPTOR pSecurityDescriptor;
  DWORD                Status;
  DWORD                Priority;
  DWORD                Position;
  DWORD                StartTime;
  DWORD                UntilTime;
  DWORD                TotalPages;
  DWORD                Size;
  SYSTEMTIME           Submitted;
  DWORD                Time;
  DWORD                PagesPrinted;
} JOB_INFO_2, *PJOB_INFO_2;

Anggota

JobId

Nilai 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").

pNotifyName

Penunjuk ke string yang dihentikan null yang menentukan nama pengguna yang harus diberi tahu ketika pekerjaan telah dicetak atau ketika kesalahan terjadi saat mencetak pekerjaan.

pDatatype

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

pPrintProcessor

Penunjuk ke string yang dihentikan null yang menentukan nama prosesor cetak yang harus digunakan untuk mencetak pekerjaan.

pParameters

Penunjuk ke string yang dihentikan null yang menentukan parameter prosesor cetak.

pDriverName

Penunjuk ke string yang dihentikan null yang menentukan nama driver printer yang harus digunakan untuk memproses pekerjaan cetak.

pDevMode

Penunjuk ke struktur DEVMODE yang berisi inisialisasi perangkat dan data lingkungan untuk driver printer.

pStatus

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

pSecurityDescriptor

Nilai anggota ini adalah NULL. Pengambilan dan pengaturan deskriptor keamanan dokumen tidak didukung dalam rilis ini.

Status

Status pekerjaan. Anggota ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
JOB_STATUS_BLOCKED_DEVQ	Pengandar tidak dapat mencetak tugas.
JOB_STATUS_DELETED	Pekerjaan telah dihapus.
JOB_STATUS_DELETING	Pekerjaan sedang dihapus.
JOB_STATUS_ERROR	Kesalahan dikaitkan dengan pekerjaan.
JOB_STATUS_OFFLINE	Pencetak 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_SPOOLING	Pekerjaan menampung.
JOB_STATUS_USER_INTERVENTION	Printer memiliki kesalahan yang mengharuskan pengguna untuk melakukan sesuatu.

Di Windows XP dan versi Windows yang lebih baru, nilai berikut juga dapat digunakan:

Nilai	Makna
JOB_STATUS_COMPLETE	Pekerjaan dikirim ke pencetak, tetapi mungkin belum dicetak. Lihat Keterangan untuk informasi selengkapnya.
JOB_STATUS_RETAINED	Pekerjaan telah dipertahankan dalam antrean cetak setelah pencetakan.

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.

StartTime

Waktu paling awal pekerjaan dapat dicetak.

UntilTime

Waktu terbaru pekerjaan dapat dicetak.

TotalPages

Jumlah halaman yang diperlukan untuk pekerjaan tersebut. Nilai ini mungkin nol jika tugas cetak tidak berisi informasi pembatas halaman.

Ukuran

Ukuran, dalam byte, dari pekerjaan.

Dikumpulkan

Struktur SYSTEMTIME yang menentukan waktu ketika pekerjaan dikirimkan.

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.

Waktu

Total waktu, dalam milidetik, yang telah berlalu sejak pekerjaan mulai mencetak.

PagesPrinted

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

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_2W (Unicode) dan _JOB_INFO_2A (ANSI)

Lihat juga

Pencetakan
Cetak Struktur API Spooler
DEVMODE
EnumJobs
GetJobs
SetJob

Bagikan melalui