Bagikan melalui


Fungsi AddPort

Fungsi AddPort menambahkan nama port ke daftar port yang didukung. Fungsi AddPort diekspor oleh pemantau port.

Sintaks

BOOL AddPort(
  _In_ LPTSTR pName,
  _In_ HWND   hWnd,
  _In_ LPTSTR pMonitorName
);

Parameter

pName [in]

Penunjuk ke string yang dihentikan nol yang menentukan nama server tempat port tersambung. Jika parameter ini NULL, port bersifat lokal.

hWnd [in]

Handel ke jendela induk kotak dialog AddPort .

pMonitorName [in]

Penunjuk ke string yang dihentikan nol yang menentukan monitor yang terkait dengan port.

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.

Fungsi AddPort menelusuri jaringan untuk menemukan port yang ada, dan menampilkan kotak dialog untuk pengguna. Fungsi AddPort harus memvalidasi nama port yang dimasukkan oleh pengguna dengan memanggil EnumPorts untuk memastikan bahwa tidak ada nama duplikat.

Pemanggil fungsi AddPort harus memiliki akses SERVER_ACCESS_ADMINISTER ke server tempat port tersambung.

Untuk menambahkan port tanpa menampilkan kotak dialog, panggil fungsi XcvData alih-alih AddPort. Untuk informasi selengkapnya tentang XcvData, lihat Microsoft Windows Driver Development Kit (DDK).

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
Spoolss.dll
Nama Unicode dan ANSI
AddPortW (Unicode) dan AddPortA (ANSI)

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

DeletePort

EnumPorts

SetPort