Fungsi DeletePrinterDataEx

Artikel
06/12/2023

Fungsi DeletePrinterDataEx menghapus nilai tertentu dari data konfigurasi untuk printer. Data konfigurasi printer terdiri dari sekumpulan nilai bernama dan jenis yang disimpan dalam hierarki kunci registri. Fungsi menghapus nilai tertentu di bawah kunci yang ditentukan.

Seperti fungsi DeletePrinterData , DeletePrinterDataEx dapat menghapus nilai yang disimpan oleh fungsi SetPrinterData . Selain itu, DeletePrinterDataEx dapat menghapus nilai yang disimpan di bawah kunci tertentu oleh fungsi SetPrinterDataEx .

Sintaks

DWORD DeletePrinterDataEx(
  _In_ HANDLE  hPrinter,
  _In_ LPCTSTR pKeyName,
  _In_ LPCTSTR pValueName
);

Parameter

hPrinter [in]

Handel ke printer yang fungsinya menghapus nilai. Gunakan fungsi OpenPrinter atau AddPrinter untuk mengambil handel printer.

pKeyName [in]

Penunjuk ke string yang dihentikan null yang menentukan kunci yang berisi nilai yang akan dihapus. Gunakan karakter garis miring terbalik ( \ ) sebagai pemisah untuk menentukan jalur yang memiliki satu atau beberapa subkunci.

Jika pKeyNameadalah NULL atau string kosong, DeletePrinterDataEx mengembalikan ERROR_INVALID_PARAMETER.

pValueName [in]

Penunjuk ke string yang dihentikan null yang menentukan nama nilai yang akan dihapus.

Nilai kembali

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	DeletePrinterDataExW (Unicode) dan DeletePrinterDataExA (ANSI)

Lihat juga

Pencetakan
Cetak Fungsi API Spooler
DeletePrinterKey
EnumPrinterDataEx
EnumPrinterKey
GetPrinterDataEx
OpenPrinter
SetPrinterDataEx

Bagikan melalui