Fungsi RemovePrintDeviceObject (winsplp.h)

  • Artikel

Peringatan

Dimulai dengan Windows 10, API yang mendukung penyedia cetak pihak ketiga tidak digunakan lagi. Microsoft tidak merekomendasikan investasi apa pun ke penyedia cetak pihak ketiga. Selain itu, pada Windows 8 dan produk yang lebih baru di mana model driver cetak v4 tersedia, penyedia cetak pihak ketiga mungkin tidak membuat atau mengelola antrean yang menggunakan driver cetak v4.

Fungsi RemovePrintDeviceObject menghapus objek perangkat dari antrean penyedia cetak.

Sintaks

HRESULT RemovePrintDeviceObject(
  [in] HANDLE hDeviceObject
);

Parameter

[in] hDeviceObject

HANDLE ke objek perangkat yang akan dihapus. Ini harus menjadi objek perangkat yang dibuat dengan AddPrintDeviceObject.

Nilai kembali

Fungsi RemovePrintDeviceObject mengembalikan S_OK, jika objek perangkat berhasil dihapus. Jika tidak, kesalahan akan ditampilkan.

Misalnya, fungsi ini dapat mengembalikan HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE), jika handel objek perangkat yang tidak valid digunakan untuk memanggil fungsi. Dan perhatikan bahwa, terlepas dari nilai yang dikembalikan, HANDLE objek perangkat menjadi tidak valid setelah panggilan ke RemovePrintDeviceObject telah selesai.

Keterangan

Panggil RemovePrintDeviceObject untuk menghapus objek perangkat untuk printer yang telah dihapus. Ketika layanan penampung berhenti, semua objek perangkat dihapus secara otomatis, sehingga tidak diperlukan untuk memanggil RemovePrintDeviceObject untuk setiap objek perangkat printer.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header winsplp.h (termasuk Winspool.h)
Pustaka WinSpool.lib
DLL WinSpool.drv

Lihat juga

AddPrintDeviceObject