Fungsi DeletePrinterDriver

Fungsi DeletePrinterDriver menghapus nama driver printer yang ditentukan dari daftar nama driver yang didukung di server.

Untuk menghapus file yang terkait dengan driver selain menghapus nama driver printer yang ditentukan dari daftar nama driver yang didukung untuk server, gunakan fungsi DeletePrinterDriverEx .

DeletePrinterDriver menghapus driver hanya jika tidak ada versi driver yang digunakan untuk lingkungan yang ditentukan. DeletePrinterDriverEx dapat menghapus versi driver tertentu.

Sintaks

BOOL DeletePrinterDriver(
  _In_ LPTSTR pName,
  _In_ LPTSTR pEnvironment,
  _In_ LPTSTR pDriverName
);

Parameter

pName [in]

Penunjuk ke string yang dihentikan null yang menentukan nama server tempat driver akan dihapus. Jika parameter ini NULL, nama printer-driver akan dihapus secara lokal.

pEnvironment [in]

Penunjuk ke string yang dihentikan null yang menentukan lingkungan tempat driver akan dihapus (misalnya, Windows x86, Windows IA64, atau Windows x64). Jika parameter ini NULL, nama driver dihapus dari lingkungan aplikasi panggilan dan komputer klien saat ini (bukan dari aplikasi tujuan dan server cetak).

pDriverName [in]

Penunjuk ke string yang dihentikan null yang menentukan nama driver yang harus dihapus.

Mengembalikan 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 dikembalikan. 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.

Pemanggil harus memiliki SeLoadDriverPrivilege.

Fungsi DeletePrinterDriver tidak menghapus file terkait, fungsi ini hanya menghapus nama driver dari daftar yang dikembalikan oleh fungsi EnumPrinterDrivers .

Sebelum memanggil DeletePrinterDriver, Anda harus menghapus semua objek printer yang menggunakan pengandar pencetak.

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
DeletePrinterDriverW (Unicode) dan DeletePrinterDriverA (ANSI)

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

DeletePrinterDriverEx

EnumPrinterDrivers