Fungsi AddPrinterDriver
Fungsi AddPrinterDriver menginstal driver printer lokal atau jarak jauh dan mengaitkan konfigurasi, data, dan file driver.
Untuk fleksibilitas lebih dalam menginstal atau meningkatkan driver printer, gunakan fungsi AddPrinterDriverEx karena memungkinkan peningkatan yang ketat, menurunkan tingkat yang ketat, menyalin file yang lebih baru saja, dan menyalin semua file (terlepas dari stempel waktu file).
Catatan
Menginstal pengandar pencetak tanpa paket pengandar tidak lagi disarankan. Gunakan InstallPrinterDriverFromPackage sebagai gantinya.
Sintaks
BOOL AddPrinterDriver(
_In_ LPTSTR pName,
_In_ DWORD Level,
_In_ LPBYTE pDriverInfo
);
Parameter
-
pName [in]
-
Penunjuk ke string yang dihentikan null yang menentukan nama server tempat driver harus diinstal.
Jika pNameadalah NULL, driver akan diinstal secara lokal.
-
Level [in]
-
Versi struktur tempat pDriverInfo menunjuk.
Nilai ini bisa 2, 3, 4, 6, atau 8.
-
pDriverInfo [in]
-
Penunjuk ke struktur yang berisi informasi pengandar printer. Ini tergantung pada nilai Level.
Nilai Struktur Kandar Printer 2 DRIVER_INFO_2 3 DRIVER_INFO_3 4 DRIVER_INFO_4 6 DRIVER_INFO_6 8 DRIVER_INFO_8 Jika anggota pEnvironment dari struktur yang ditunjukkan oleh pDriverInfo adalah NULL, lingkungan pemanggil/klien saat ini (bukan tujuan/server) digunakan.
Nilai kembali
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.
Sebelum aplikasi memanggil fungsi AddPrinterDriver , semua file yang diperlukan oleh driver harus disalin ke direktori driver printer sistem. Aplikasi dapat mengambil nama direktori ini dengan memanggil fungsi GetPrinterDriverDirectory .
Aplikasi dapat menentukan driver printer mana yang saat ini diinstal dengan memanggil fungsi EnumPrinterDrivers .
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 |
|
| Nama Unicode dan ANSI |
AddPrinterDriverW (Unicode) dan AddPrinterDriverA (ANSI) |