Fungsi SetPort

Fungsi SetPort mengatur status yang terkait dengan port printer.

Sintaks

BOOL SetPort(
  _In_ LPTSTR pName,
  _In_ LPTSTR pPortName,
  _In_ DWORD  dwLevel,
  _In_ LPBYTE pPortInfo
);

Parameter

pName [in]

Penunjuk ke string yang dihentikan nol yang menentukan nama server printer tempat port tersambung. Atur parameter ini ke NULL jika port berada di komputer lokal.

pPortName [in]

Penunjuk ke string yang dihentikan nol yang menentukan nama port printer.

dwLevel [in]

Menentukan jenis struktur yang ditujukkan oleh parameter pPortInfo .

Nilai ini harus 3, yang sesuai dengan struktur data PORT_INFO_3 .

pPortInfo [in]

Penunjuk ke struktur PORT_INFO_3 yang berisi informasi status port yang akan diatur.

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.

Pemanggil fungsi SetPort harus dijalankan sebagai Administrator. Selain itu, jika pemanggil adalah Pemantau Port atau Monitor Bahasa, pemanggil harus memanggil RevertToSelf untuk menghentikan peniruan sebelum memanggil SetPort.

Semua program yang memanggil SetPort harus memiliki akses SERVER_ACCESS_ADMINISTER ke server tempat port tersambung.

Ketika Anda mengatur nilai status port printer dengan nilai tingkat keparahan PORT_STATUS_TYPE_ERROR, penampung cetak berhenti mengirim pekerjaan ke port. Penampung cetak melanjutkan pengiriman pekerjaan ke port ketika status port dibersihkan oleh panggilan lain ke SetPort.

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	SetPortW (Unicode) dan SetPortA (ANSI)

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

PORT_INFO_3