Funzione XcvOpenPort (winsplp.h)

Articolo
02/27/2024

La funzione XcvOpenPort di un server di monitoraggio delle porte apre una porta per le operazioni di configurazione.

Sintassi

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

Parametri

pszObject

Puntatore fornito dal chiamante a una stringa che rappresenta il nome della porta. Può essere NULL e la maggior parte dei monitoraggi non ha bisogno di questo parametro.

GrantedAccess

Struttura di ACCESS_MASK fornita dal chiamante contenente l'accesso concesso all'utente durante una chiamata della DLL dell'interfaccia utente di monitoraggio di stampa alla funzione OpenPrinter di spooler . Vedere la sezione Osservazioni seguenti.

phXcv

Puntatore fornito dal chiamante a una posizione per ricevere un handle di porta fornito dalla funzione.

Valore restituito

Se l'operazione ha esito positivo, la funzione deve restituire TRUE. In caso contrario, deve restituire FALSE.

Commenti

Le DLL del server di monitoraggio delle porte sono necessarie per definire una funzione XcvOpenPort e includere il relativo indirizzo in una struttura MONITOR2 .

La funzione OpenPrinter di spooler (descritta nella documentazione di Microsoft Windows SDK) chiama XcvOpenPort se il nome della stampante specificato include le stringhe "XcvPort" o "XcvMonitor". Per altre informazioni, vedere AddPortUI.

La funzione XcvOpenPort deve aprire la porta a scopo di configurazione. Questa operazione potrebbe essere costituita solo dall'archiviazione degli argomenti di input per l'uso successivo all'interno di XcvDataPort. La funzione deve restituire un handle alle informazioni archiviate nella posizione a cui punta phXcv. Questo handle viene restituito al chiamante di OpenPrinter e successivamente ricevuto come argomento di input a XcvDataPort.

La funzione deve salvare la maschera di accesso concessa. In seguito, quando viene chiamata la funzione XcvDataPort della DLL del server, l'accesso concesso deve essere confrontato con SERVER_ACCESS_ADMINISTER e se il confronto ha esito negativo, XcvDataPort deve restituire ERROR_ACCESS_DENIED.