Fungsi UploadPrinterDriverPackage

Mengunggah driver printer ke penyimpanan driver server cetak sehingga dapat diinstal dengan memanggil InstallPrinterDriverFromPackage.

Sintaks

HRESULT UploadPrinterDriverPackage(
  _In_    LPCTSTR pszServer,
  _In_    LPCTSTR pszInfPath,
  _In_    LPCTSTR pszEnvironment,
  _In_    DWORD   dwFlags,
  _In_    HWND    hwnd,
  _Out_   LPTSTR  pszDestInfPath,
  _Inout_ PULONG  pcchDestInfPath
);

Parameter

pszServer [in]

Penunjuk ke string konstanta yang dihentikan null yang menentukan nama server cetak. Gunakan NULL jika server adalah komputer lokal.

pszInfPath [in]

Penunjuk ke string konstanta ,null-terminated yang menentukan jalur sumber ke file .inf driver.

pszEnvironment [in]

Penunjuk ke string konstanta yang dihentikan null yang menentukan arsitektur prosesor server (misalnya, Windows NT x86). Ini bisa NULL.

dwFlags [in]

Ini bisa menjadi salah satu nilai berikut:

Nilai Makna
UPDP_SILENT_UPLOAD
UI tidak akan ditampilkan selama unggahan.
UPDP_UPLOAD_ALWAYS
File akan diunggah meskipun paket sudah ada di penyimpanan driver server.
UPDP_CHECK_DRIVERSTORE
Penyimpanan driver server akan diperiksa sebelum diunggah untuk melihat apakah paket sudah ada. Pengaturan ini diabaikan jika UPDP_UPLOAD_ALWAYS diatur.

hwnd [in]

Handel ke antarmuka pengguna penyalinan.

pszDestInfPath [out]

Penunjuk ke jalur tujuan, di penyimpanan driver, tempat file .inf driver disalin.

pcchDestInfPath [masuk, keluar]

Pada input, menentukan ukuran, dalam karakter, dari buffer pszDestInfPath . Pada output, menerima ukuran, dalam karakter, dari string jalur, termasuk karakter null yang mengakhiri.

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

Penyimpanan driver biasanya berupa %windir%\inf atau %windir%\System32\DriverStore\FileRepository.

Hanya satu paket pada satu waktu yang dapat diunggah. Jika paket bergantung pada yang lain, paket harus diunggah secara terpisah.

Hanya paket driver yang ditandatangani yang dapat diunggah.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung
Windows Server 2008 [hanya aplikasi desktop]
Header
Winspool.h (termasuk Windows.h)
Pustaka
Winspool.lib
DLL
Spoolss.dll
Nama Unicode dan ANSI
UploadPrinterDriverPackageW (Unicode) dan UploadPrinterDriverPackageA (ANSI)

Lihat juga

Pencetakan

Cetak Fungsi API Spooler