Fungsi DeletePrinterData

Fungsi DeletePrinterData menghapus data konfigurasi tertentu untuk printer. Data konfigurasi printer terdiri dari sekumpulan nilai bernama dan yang ditik. Fungsi DeletePrinterData menghapus salah satu nilai ini, yang ditentukan oleh nama nilainya.

Memanggil DeletePrinterData setara dengan memanggil fungsi DeletePrinterDataEx dengan parameter pKeyName yang diatur ke "PrinterDriverData".

Sintaks

DWORD DeletePrinterData(
  _In_ HANDLE hPrinter,
  _In_ LPTSTR pValueName
);

Parameter

hPrinter [in]

Handel ke printer yang data konfigurasinya akan dihapus. Gunakan fungsi OpenPrinter atau AddPrinter untuk mengambil handel printer.

pValueName [in]

Penunjuk ke nama nilai data konfigurasi yang dihentikan null yang akan dihapus.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem.

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.

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
Winspool.drv
Nama Unicode dan ANSI
DeletePrinterDataW (Unicode) dan DeletePrinterDataA (ANSI)

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

EnumPrinterData

GetPrinterData

OpenPrinter

SetPrinter

SetPrinterData