Fungsi AbortDoc (wingdi.h)

Fungsi AbortDoc menghentikan pekerjaan cetak saat ini dan menghapus semuanya yang digambar sejak panggilan terakhir ke fungsi StartDoc .

Sintaks

int AbortDoc(
  [in] HDC hdc
);

Parameter

[in] hdc

Tangani konteks perangkat untuk pekerjaan cetak.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan lebih besar dari nol.

Jika fungsi gagal, nilai yang dikembalikan SP_ERROR.

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 implementasi driver printer—faktor-faktor yang sulit diprediksi saat menulis aplikasi. Memanggil fungsi ini dari utas yang mengelola interaksi dengan antarmuka pengguna dapat membuat aplikasi tampak tidak responsif.

 

Aplikasi harus memanggil fungsi AbortDoc untuk menghentikan pekerjaan cetak jika terjadi kesalahan, atau untuk menghentikan pekerjaan cetak setelah pengguna membatalkan pekerjaan tersebut. Untuk mengakhiri pekerjaan cetak yang berhasil, aplikasi harus memanggil fungsi EndDoc .

Jika Print Manager digunakan untuk memulai pekerjaan cetak, memanggil AbortDoc menghapus seluruh pekerjaan spool, sehingga printer tidak menerima apa pun. Jika Print Manager tidak digunakan untuk memulai tugas cetak, data mungkin sudah dikirim ke pencetak. Dalam hal ini, pengandar pencetak mengatur ulang pencetak (jika memungkinkan) dan mengakhiri tugas cetak.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll

Lihat juga

EndDoc

Cetak Fungsi API Spooler

Pencetakan

SetAbortProc

StartDoc