Fungsi ReportJobProcessingProgress

Melaporkan ke layanan Print Spooler apakah pekerjaan cetak XPS sedang dalam tahap penampungan atau penyajian dan bagian apa dari pemrosesan yang saat ini sedang berlangsung.

Sintaks

HRESULT ReportJobProcessingProgress(
  _In_ HANDLE                printerHandle,
  _In_ ULONG                 jobId,
       EPrintXPSJobOperation jobOperation,
       EPrintXPSJobProgress  jobProgress
);

Parameter

printerHandle [in]

Handel printer yang fungsinya untuk mengambil informasi. 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.

jobOperation

Menentukan apakah pekerjaan berada dalam fase spooling atau fase penyajian.

jobProgress

Menentukan bagian mana dari pemrosesan yang saat ini sedang berlangsung. Nilai ini mengacu pada peristiwa dalam fase spooling atau rendering tergantung pada nilai jobOperation.

Nilai kembali

Jika operasi berhasil, nilai yang dikembalikan S_OK, jika tidak , HRESULT akan berisi kode kesalahan.

Untuk informasi selengkapnya tentang kode kesalahan COM, lihat Penanganan Kesalahan.

Keterangan

Catatan

Ini adalah fungsi pemblokiran atau sinkron dan mungkin tidak segera kembali. 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.

Catatan

ReportJobProcessingProgress hanya akan melaporkan kemajuan pekerjaan cetak XPS jika pekerjaan cetak dalam fase penampungan atau penyajian. ReportJobProcessingProgress akan gagal jika dipanggil ketika pekerjaan cetak XPS tidak dalam fase penampungan atau penyajian.

Persyaratan

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

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

EPrintXPSJobOperation

EPrintXPSJobProgress