Fungsi ConnectToPrinterDlg

Artikel
06/12/2023

Fungsi ConnectToPrinterDlg menampilkan kotak dialog yang memungkinkan pengguna menelusuri dan menyambungkan ke printer di jaringan. Jika pengguna memilih printer, fungsi mencoba membuat koneksi ke printer tersebut; jika driver yang sesuai tidak diinstal pada server, pengguna diberi opsi untuk membuat printer secara lokal.

Sintaks

HANDLE ConnectToPrinterDlg(
  _In_ HWND  hwnd,
  _In_ DWORD Flags
);

Parameter

hwnd [in]: Menentukan jendela induk kotak dialog.
Bendera [in]: Parameter ini dicadangkan dan harus nol.

Mengembalikan nilai

Jika fungsi berhasil dan pengguna memilih printer, nilai yang dikembalikan adalah handel ke printer yang dipilih.

Jika fungsi gagal, atau pengguna membatalkan kotak dialog tanpa memilih printer, nilai yang dikembalikan adalah NULL.

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.

Fungsi ConnectToPrinterDlg mencoba membuat koneksi ke printer yang dipilih. Namun, jika server tempat printer berada tidak memiliki pengandar yang cocok yang terinstal, fungsi ini menawarkan opsi kepada pengguna untuk membuat printer secara lokal. Aplikasi panggilan dapat menentukan apakah fungsi telah membuat printer secara lokal dengan memanggil GetPrinter dengan struktur PRINTER_INFO_2 , lalu memeriksa anggota Atribut struktur tersebut.

Aplikasi harus memanggil DeletePrinter untuk menghapus printer lokal. Aplikasi harus memanggil DeletePrinterConnection untuk menghapus koneksi ke printer.

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

Lihat juga

Pencetakan
Cetak Fungsi API Spooler
AddPrinterConnection
ClosePrinter
DeletePrinter
DeletePrinterConnection
GetPrinter
PRINTER_INFO_2

Share via