Fungsi AddPrintProcessor

Fungsi AddPrintProcessor menginstal prosesor cetak pada server yang ditentukan dan menambahkan nama prosesor cetak ke daftar prosesor cetak yang didukung.

Sintaks

BOOL AddPrintProcessor(
  _In_ LPTSTR pName,
  _In_ LPTSTR pEnvironment,
  _In_ LPTSTR pPathName,
  _In_ LPTSTR pPrintProcessorName
);

Parameter

pName [in]

Penunjuk ke string yang dihentikan null yang menentukan nama server tempat prosesor cetak harus diinstal. Jika parameter ini NULL, prosesor cetak diinstal secara lokal.

pEnvironment [in]

Penunjuk ke string yang dihentikan null yang menentukan lingkungan (misalnya, Windows x86, Windows IA64, atau Windows x64). Jika parameter ini ADALAH NULL, lingkungan penelepon/klien saat ini (bukan tujuan/server) digunakan.

pPathName [in]

Penunjuk ke string yang dihentikan null yang menentukan nama file yang berisi prosesor cetak. File ini harus dalam direktori prosesor-cetak sistem.

pPrintProcessorName [in]

Penunjuk ke string yang dihentikan null yang menentukan nama prosesor cetak.

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.

Sebelum memanggil fungsi AddPrintProcessor , aplikasi harus memverifikasi bahwa file yang berisi prosesor cetak disimpan dalam direktori prosesor cetak sistem. Aplikasi dapat mengambil nama direktori prosesor cetak sistem dengan memanggil fungsi GetPrintProcessorDirectory .

Aplikasi dapat menentukan nama prosesor cetak yang ada dengan memanggil fungsi EnumPrintProcessors .

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	AddPrintProcessorW (Unicode) dan AddPrintProcessorA (ANSI)

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

EnumPrintProcessors

GetPrintProcessorDirectory