Fungsi AddPrinterConnection2

Artikel
06/12/2023

Menambahkan sambungan ke pencetak yang ditentukan untuk pengguna saat ini dan menentukan detail koneksi.

Sintaks

BOOL AddPrinterConnection2(
  _In_ HWND    hWnd,
  _In_ LPCTSTR pszName,
       DWORD   dwLevel,
  _In_ PVOID   pConnectionInfo
);

Parameter

hWnd [in]: Handel ke jendela induk tempat kotak dialog akan ditampilkan jika sistem cetak harus mengunduh pengandar pencetak dari server cetak untuk sambungan ini.
pszName [in]: Penunjuk ke string konstanta yang dihentikan null yang menentukan nama printer yang ingin disambungkan oleh pengguna saat ini.
dwLevel: Versi struktur yang diarahkan oleh pConnectionInfo. Saat ini, hanya tingkat 1 yang didefinisikan sehingga nilai dwLevel harus 1.
pConnectionInfo [in]: Penunjuk ke struktur PRINTER_CONNECTION_INFO_1 . Lihat bagian Keterangan untuk informasi selengkapnya tentang parameter ini.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

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.

Ketika Windows Vista membuat sambungan ke pencetak, maka mungkin perlu menyalin berkas pengandar pencetak dari server tempat pencetak terpasang. Jika pengguna tidak memiliki izin untuk menyalin file ke lokasi yang sesuai, fungsi AddPrinterConnection2 gagal dan GetLastError mengembalikan ERROR_ACCESS_DENIED.

Jika file pengandar pencetak harus disalin dari server cetak tetapi tidak dapat disalin secara diam-diam karena kebijakan grup yang berlaku dan PRINTER_CONNECTION_NO_UI diatur dalam pConnectionInfo-dwFlags>, tidak ada kotak dialog yang akan ditampilkan dan panggilan akan gagal.

Jika pengandar pencetak lokal dapat digunakan untuk merender tugas cetak untuk pencetak ini dan versi pengandar lokal tidak boleh cocok dengan versi driver printer pada server, atur PRINTER_CONNECTION_MISMATCH dalam pConnectionInfo-dwFlags> dan tetapkan penunjuk ke variabel string yang berisi jalur ke driver printer lokal ke pConnectionInfo-pszDriverName>.

Koneksi printer yang dibuat dengan memanggil AddPrinterConnection2 akan dijumlahkan ketika EnumPrinters dipanggil dengan dwType diatur ke PRINTER_ENUM_CONNECTION.

Versi ANSI dari fungsi ini, AddPrinterConnection2A, tidak didukung dan mengembalikan ERROR_NOT_SUPPORTED.

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	Winspool.drv
Nama Unicode dan ANSI	AddPrinterConnection2W (Unicode)

Lihat juga

Pencetakan
Cetak Fungsi API Spooler
ConnectToPrinterDlg
EnumPrinters
DeletePrinterConnection

Bagikan melalui