Fungsi AddPrintProvidor

Penting

Pada 6 Juli 2021, KB5005010 memperkenalkan opsi konfigurasi berbasis registri opsional untuk membatasi akses ke API ini hanya untuk pengguna admin. Opsi ini nonaktif menjadi default.

Pada 10 Agustus 2021, KB5005652 mengubah nilai default konfigurasi ini untuk memerlukan hak admin untuk menginstal driver printer baru.

Fungsi AddPrintProvidor menginstal penyedia cetak lokal dan menautkan file konfigurasi, data, dan penyedia.

Sintaks

BOOL AddPrintProvidor(
  _In_ LPTSTR pName,
  _In_ DWORD  Level,
  _In_ LPBYTE pProviderInfo
);

Parameter

pName [in]

Penunjuk ke string yang dihentikan null yang menentukan nama server tempat penyedia harus diinstal. Untuk sistem yang hanya mendukung penginstalan penyedia lokal, parameter ini harus NULL.

Level [in]

Tingkat struktur tempat pProviderInfo menunjuk. Ini bisa menjadi salah satu dari berikut ini.

Nilai	Makna
1	Fungsi menggunakan struktur PROVIDOR_INFO_1 .
2	Fungsi menggunakan struktur PROVIDOR_INFO_2 .

pProviderInfo [in]

Penunjuk ke struktur penyedia cetak, seperti yang ditunjukkan oleh Tingkat.

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

Sebelum aplikasi memanggil fungsi AddPrintProvidor , semua file yang diperlukan oleh penyedia harus disalin ke direktori SYSTEM32.

Penyedia yang ditambahkan oleh AddPrintProvidor dapat dihapus dengan memanggil DeletePrintProvidor.

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	AddPrintProvidorW (Unicode) dan AddPrintProvidorA (ANSI)

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

DeletePrintProvidor

PROVIDOR_INFO_1

PROVIDOR_INFO_2