Fungsi GetPrinterDriverPackagePath

Mengambil jalur ke paket pengandar pencetak yang ditentukan pada server cetak.

Sintaks

HRESULT GetPrinterDriverPackagePath(
  _In_    LPCTSTR pszServer,
  _In_    LPCTSTR pszEnvironment,
  _In_    LPCTSTR pszLanguage,
  _In_    LPCTSTR pszPackageID,
  _Inout_ LPTSTR  pszDriverPackageCab,
  _In_    DWORD   cchDriverPackageCab,
  _Out_   LPDWORD pcchRequiredSize
);

Parameter

pszServer [in]

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

pszEnvironment [in]

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

pszLanguage [in]

Penunjuk ke string konstanta yang dihentikan null yang menentukan bahasa Antarmuka Pengguna Multibahasa untuk driver yang diinstal. Ini bisa NULL.

pszPackageID [in]

Penunjuk ke string konstanta yang dihentikan null yang menentukan ID paket driver.

pszDriverPackageCab [masuk, keluar]

Penunjuk ke string yang dihentikan null yang menentukan jalur ke file kabinet untuk paket driver. Ini bisa NULL. Lihat Keterangan.

cchDriverPackageCab [in]

Ukuran, dalam karakter, dari buffer pszDriverPackageCab . Ini bisa NULL.

pcchRequiredSize [out]

Penunjuk ke ukuran buffer pszDriverPackageCab yang diperlukan.

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.

Untuk mendapatkan nilai untuk cchDriverPackageCab, panggil fungsi dengan NULL sebagai nilai pszDriverPackageCab. Gunakan nilai yang dikembalikan di pcchRequiredSize sebagai nilai cchDriverPackageCab dan panggil fungsi lagi.

pszPackageID biasanya diperoleh dari panggilan ke GetCorePrinterDrivers.

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	GetPrinterDriverPackagePathW (Unicode) dan GetPrinterDriverPackagePathA (ANSI)

Lihat juga

Pencetakan

Cetak Fungsi API Spooler