Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Menginstal pengandar pencetak dari paket pengandar yang ada di penyimpanan pengandar server cetak.
Sintaks
HRESULT InstallPrinterDriverFromPackage(
_In_ LPCTSTR pszServer,
_In_ LPCTSTR pszInfPath,
_In_ LPCTSTR pszDriverName,
_In_ LPCTSTR pszEnvironment,
_In_ DWORD dwFlags
);
Parameter
-
pszServer [in]
-
Penunjuk ke string konstanta yang dihentikan null yang menentukan nama server cetak. NULL berarti komputer lokal.
-
pszInfPath [in]
-
Penunjuk ke string konstanta yang dihentikan null yang menentukan jalur penyimpanan driver ke file .inf driver cetak. NULL berarti driver berada dalam file inf yang dikirim dengan Windows.
-
pszDriverName [in]
-
Penunjuk ke string konstanta yang dihentikan null yang menentukan nama driver.
-
pszEnvironment [in]
-
Penunjuk ke string konstanta yang dihentikan null yang menentukan arsitektur prosesor (misalnya, Windows NT x86). Ini bisa NULL.
-
dwFlags [in]
-
Ini hanya bisa 0 atau IPDFP_COPY_ALL_FILES. Nilai 0 berarti bahwa pengandar pencetak harus ditambahkan dan berkas apa pun dalam direktori pengandar pencetak yang lebih baru dari berkas yang sesuai yang saat ini digunakan harus disalin. Nilai IPDFP_COPY_ALL_FILES berarti pengandar pencetak dan semua berkas dalam direktori pengandar pencetak harus ditambahkan. Stempel waktu file diabaikan ketika dwFlags memiliki nilai IPDFP_COPY_ALL_FILES.
Mengembalikan nilai
Jika operasi berhasil, nilai yang dikembalikan S_OK, jika tidak , HRESULT akan berisi kode kesalahan.
Untuk informasi selengkapnya tentang kode kesalahan COM, lihat Penanganan Kesalahan.
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.
Penyimpanan driver biasanya %windir%\inf atau %windir%\System32\DriverStore\FileRepository.
InstallPrinterDriverFromPackage juga menginstal file lain dalam paket, seperti profil warna dan prosesor cetak.
Pengguna harus memiliki hak administrasi printer untuk menginstal baik di komputer jarak jauh atau di komputer lokal ketika pengguna masuk dengan Layanan Terminal.
Hanya paket bertanda tangan yang dapat diinstal pada komputer jarak jauh.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows Server 2008 [hanya aplikasi desktop] |
| Header |
|
| Pustaka |
|
| DLL |
|
| Nama Unicode dan ANSI |
InstallPrinterDriverFromPackageW (Unicode) dan InstallPrinterDriverFromPackageA (ANSI) |