Metode IXpsPrintJob::GetJobStatus (xpsprint.h)

Artikel
12/22/2023

[IXpsPrintJob::GetJobSatus tidak didukung dan dapat diubah atau tidak tersedia di masa mendatang. ]

Mendapatkan status pekerjaan cetak saat ini.

Sintaks

HRESULT GetJobStatus(
  [out, retval] XPS_JOB_STATUS *jobStatus
);

Parameter

[out, retval] jobStatus

Status tugas cetak saat ini. Untuk informasi tentang data yang dikembalikan dalam struktur ini, lihat XPS_JOB_STATUS.

Mengembalikan nilai

Jika metode berhasil, metode akan mengembalikan S_OK; jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

GetJobStatus dapat dipanggil selama pemrosesan pekerjaan cetak atau setelah pekerjaan cetak selesai. Nilai yang dikembalikan dalam XPS_JOB_STATUS mewakili status pekerjaan cetak saat ini pada saat GetJobStatus dipanggil, sehingga dimungkinkan untuk melewatkan status menengah antara panggilan ke metode ini.

Nilai jobStatus.currentDocument dan jobStatus.currentPage dijamin akan mengalami kemajuan secara berurutan: dari dokumen pertama hingga yang terakhir, dan dari halaman pertama hingga yang terakhir dalam setiap dokumen.

ID pekerjaan dari pekerjaan cetak yang telah dikirim ke Microsoft XPS Document Writer (MXDW) adalah nol. Jika antarmuka adalah pekerjaan cetak yang telah dikirim ke MXDW, nol akan dikembalikan dalam jobStatus.jobId.

Jika tidak ada ID pekerjaan yang ditetapkan ke pekerjaan cetak, atau pekerjaan cetak dicetak tanpa menampung, nol akan dikembalikan dalam jobStatus.jobId.

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	xpsprint.h