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 |
|
| Pustaka |
|
| DLL |
|