Fungsi DeletePrinter

Fungsi DeletePrinter menghapus objek printer yang ditentukan.

Sintaks

BOOL DeletePrinter(
  _Inout_ HANDLE hPrinter
);

Parameter

hPrinter [masuk, keluar]

Tangani ke objek printer yang akan dihapus. Gunakan fungsi OpenPrinter atau AddPrinter untuk mengambil handel printer.

Menampilkan nilai

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

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

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.

Jika ada tugas cetak yang tersisa untuk diproses untuk printer yang ditentukan, DeletePrinter menandai printer untuk penghapusan yang tertunda, lalu menghapusnya ketika semua pekerjaan cetak telah dicetak. Tidak ada tugas cetak yang dapat ditambahkan ke printer yang ditandai untuk penghapusan tertunda.

Printer yang ditandai untuk penghapusan tertunda tidak dapat ditahan, tetapi tugas cetaknya dapat ditahan, dilanjutkan, dan dimulai ulang. Jika printer ditahan dan ada pekerjaan untuk printer, DeletePrinter gagal dengan ERROR_ACCESS_DENIED.

Perhatikan bahwa DeletePrinter tidak menutup handel yang diteruskan ke dalamnya. Dengan demikian, aplikasi masih harus memanggil ClosePrinter.

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)
Pustaka	Winspool.lib
DLL	Spoolss.dll

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

TambahkanPrinter

EnumPrinters

OpenPrinter