Mengonfigurasi fungsiPortUI (winsplp.h)

Artikel
03/05/2024

Fungsi ConfigurePortUI UI MONITOR port DLL mendapatkan informasi konfigurasi port dari pengguna dan mengirimkannya ke DLL server pemantau port.

Sintaks

BOOL WINAPI pfnConfigurePortUI(
  _In_opt_ PCWSTR pszServer,
  _In_     HWND   hWnd,
  _In_     PCWSTR pszPortName
);

Parameter

[in, optional] pszServer

Penunjuk yang disediakan penelepon ke string yang mewakili nama server, atau NULL jika printer lokal. (Pemantau port dapat mengabaikan parameter ini.)

[in] hWnd

Handel jendela yang disediakan penelepon yang harus digunakan sebagai induk untuk kotak dialog. Jika NULL, tidak ada kotak dialog yang harus ditampilkan.

[in] pszPortName

Penunjuk yang disediakan penelepon ke string yang mewakili nama port yang akan dikonfigurasi.

Nilai kembali

Jika operasi berhasil, fungsi harus mengembalikan TRUE. Jika tidak, maka akan mengembalikan FALSE. Jika operasi tidak didukung, atau dibatalkan oleh pengguna (baik dengan memilih BATALkan atau dengan memilih OK tanpa mengubah parameter konfigurasi), fungsi harus memanggil SetLastError(ERROR_CANCELLED), lalu mengembalikan FALSE.

Keterangan

DLL UI monitor port diperlukan untuk menentukan fungsi ConfigurePortUI dan menyertakan alamat fungsi dalam struktur MONITORUI .

Penampung klien memanggil ConfigurePortUI dari dalam fungsi ConfigurePort (dijelaskan dalam dokumentasi Microsoft Windows SDK). Argumen yang diterima oleh ConfigurePortUI adalah argumen yang diterima oleh ConfigurePort.

Fungsi harus melakukan operasi berikut:

Panggil OpenPrinter, menentukan nama printer dengan format berikut:

\\ServerName\,XcvPortPortName

di mana ServerName dan PortName adalah nama server dan port yang diterima sebagai argumen fungsi ConfigurePortUI .

Panggilan ke OpenPrinter memerlukan struktur PRINTER_DEFAULTS, yang dijelaskan dalam dokumentasi Windows SDK. Anggota DesiredAccess struktur harus diatur ke SERVER_ACCESS_ADMINISTER. Anggota pDatatype dan pDevMode-nya bisa NULL.

Panggilan ini menyebabkan fungsi XcvOpenPort server monitor cetak dipanggil.
Dapatkan parameter konfigurasi port dari pengguna dengan menampilkan kotak dialog.
Panggil XcvData satu atau beberapa kali, menentukan string nama data yang disesuaikan, untuk mengirim setiap parameter konfigurasi ke DLL server. Setiap panggilan XcvData menyebabkan fungsi XcvDataPort server dipanggil.
Panggil ClosePrinter, menentukan handel yang diterima dari OpenPrinter. Ini menyebabkan fungsi XcvClosePort DLL server dipanggil.