Fungsi EndDocPrinter

Fungsi EndDocPrinter mengakhiri pekerjaan cetak untuk printer yang ditentukan.

Sintaksis

BOOL EndDocPrinter(
  _In_ HANDLE hPrinter
);

Parameter-parameternya

hPrinter [in]

Tangani ke pencetak yang tugas cetaknya harus diakhir. Gunakan fungsi OpenPrinter atau AddPrinter untuk mengambil handel printer.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Komentar

Nota

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.

Fungsi EndDocPrinter mengembalikan kesalahan jika pekerjaan cetak tidak dimulai dengan memanggil fungsi StartDocPrinter .

Urutan untuk pekerjaan cetak adalah sebagai berikut:

1. Untuk memulai pekerjaan cetak, panggil StartDocPrinter.
2. Untuk memulai setiap halaman, panggil StartPagePrinter.
3. Untuk menulis data ke halaman, panggil WritePrinter.
4. Untuk mengakhiri setiap halaman, panggil EndPagePrinter.
5. Ulangi 2, 3, dan 4 untuk halaman sebanyak yang diperlukan.
6. Untuk mengakhiri pekerjaan cetak, panggil EndDocPrinter.

Ketika halaman dalam file yang ditampung melebihi sekitar 350 MB, halaman mungkin gagal mencetak dan tidak mengirim pesan kesalahan. Misalnya, ini dapat terjadi saat mencetak file EMF besar. Batas ukuran halaman tergantung pada banyak faktor termasuk jumlah memori virtual yang tersedia, jumlah memori yang dialokasikan dengan proses panggilan, dan jumlah fragmentasi dalam tumpukan proses.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Kepala Halaman	Winspool.h (termasuk Windows.h)
Perpustakaan	Winspool.lib
DLL	Spoolss.dll

Lihat juga

Pencetakan

Print Spooler API

EndPagePrinter

StartDocPrinter

StartPagePrinter

WritePrinter