Bagikan melalui


Fungsi DeletePort

Fungsi DeletePort menampilkan kotak dialog yang memungkinkan pengguna menghapus nama port.

Sintaks

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

Parameter

pName [in]

Penunjuk ke string yang dihentikan nol yang menentukan nama server tempat port harus dihapus. Jika parameter ini NULL, port lokal akan dihapus.

hWnd [in]

Handel ke jendela induk kotak dialog penghapusan port.

pPortName [in]

Penunjuk ke string yang dihentikan nol yang menentukan nama port yang harus dihapus.

Menampilkan 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.

Aplikasi dapat mengambil nama port yang valid dengan memanggil fungsi EnumPorts .

Fungsi DeletePort mengembalikan kesalahan jika printer saat ini tersambung ke port yang ditentukan.

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

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
DeletePortW (Unicode) dan DeletePortA (ANSI)

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

AddPort

EnumPorts