Fungsi AddPrinterConnection
Fungsi AddPrinterConnection menambahkan koneksi ke printer yang ditentukan untuk pengguna saat ini.
Sintaks
BOOL AddPrinterConnection(
_In_ LPTSTR pName
);
Parameter
-
pName [in]
-
Penunjuk ke string yang dihentikan null yang menentukan nama printer tempat pengguna saat ini ingin membuat koneksi.
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.
Ketika Windows membuat sambungan ke pencetak, mungkin perlu menyalin berkas pengandar pencetak ke server tempat pencetak terpasang. Jika pengguna tidak memiliki izin untuk menyalin file ke lokasi yang sesuai, fungsi AddPrinterConnection gagal, dan GetLastError mengembalikan ERROR_ACCESS_DENIED.
Koneksi printer yang dibuat dengan memanggil AddPrinterConnection akan dijumlahkan ketika EnumPrinters dipanggil dengan dwType diatur ke PRINTER_ENUM_CONNECTION.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
| Header |
|
| Pustaka |
|
| DLL |
|
| Nama Unicode dan ANSI |
AddPrinterConnectionW (Unicode) dan AddPrinterConnectionA (ANSI) |