Fungsi ConfigurePort

Fungsi ConfigurePort menampilkan kotak dialog konfigurasi port untuk port pada server yang ditentukan.

Sintaks

BOOL ConfigurePort(
  _In_ LPTSTR pName,
  _In_ HWND   hWnd,
  _In_ LPTSTR pPortName
);

Parameter

pName [in]

Penunjuk ke string yang dihentikan null yang menentukan nama server tempat port yang ditentukan ada. Jika parameter ini NULL, port bersifat lokal.

hWnd [in]

Tangani ke jendela induk kotak dialog konfigurasi port.

pPortName [in]

Penunjuk ke string yang dihentikan null yang menentukan nama port yang akan dikonfigurasi.

Mengembalikan nilai

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.

Sebelum memanggil fungsi ConfigurePort , aplikasi harus memanggil fungsi EnumPorts untuk menentukan nama port yang valid.

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
Nama Unicode dan ANSI	ConfigurePortW (Unicode) dan ConfigurePortA (ANSI)

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

EnumPorts