Fungsi XcvOpenPort (winsplp.h)

Artikel
02/27/2024

Fungsi XcvOpenPort server monitor port membuka port untuk operasi konfigurasi.

Sintaks

BOOL XcvOpenPort(
  LPCWSTR     pszObject,
  ACCESS_MASK GrantedAccess,
  PHANDLE     phXcv
);

Parameter

pszObject

Penunjuk yang disediakan penelepon ke string yang mewakili nama port. Bisa NULL, dan sebagian besar monitor tidak memerlukan parameter ini.

GrantedAccess

Struktur ACCESS_MASK yang disediakan penelepon yang berisi akses yang diberikan kepada pengguna selama panggilan DLL UI monitor cetak ke fungsi OpenPrinter penampung. Lihat bagian Keterangan berikut.

phXcv

Penunjuk yang disediakan penelepon ke lokasi untuk menerima handel port yang disediakan fungsi.

Nilai kembali

Jika operasi berhasil, fungsi harus mengembalikan TRUE. Jika tidak, maka akan mengembalikan FALSE.

Keterangan

DLL server monitor port diperlukan untuk menentukan fungsi XcvOpenPort dan menyertakan alamatnya dalam struktur MONITOR2 .

Fungsi OpenPrinter penampung (dijelaskan dalam dokumentasi Microsoft Windows SDK) memanggil XcvOpenPort jika nama printer yang ditentukan menyertakan salah satu string "XcvPort" atau "XcvMonitor". Untuk informasi selengkapnya, lihat AddPortUI.

Fungsi XcvOpenPort harus membuka port untuk tujuan konfigurasi. Operasi ini mungkin hanya terdiri dari menyimpan argumen input untuk penggunaan berikutnya dalam XcvDataPort. Fungsi harus mengembalikan handel ke informasi yang disimpan di lokasi yang ditunjukkan oleh phXcv. Handel ini dikembalikan ke pemanggil OpenPrinter, dan kemudian diterima sebagai argumen input ke XcvDataPort.

Fungsi harus menyimpan masker akses yang diberikan. Kemudian, ketika fungsi XcvDataPort DLL server dipanggil, akses yang diberikan harus dibandingkan dengan SERVER_ACCESS_ADMINISTER dan jika perbandingan gagal, XcvDataPort harus mengembalikan ERROR_ACCESS_DENIED.