Fungsi ConnectToPrinterDlg
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 |
|
| Pustaka |
|
| DLL |
|