Funzione XcvOpenPort (winsplp.h)

Articolo
02/07/2025

La funzione XcvOpenPort di una DLL del 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 NULLe la maggior parte dei monitoraggi non richiede questo parametro.

GrantedAccess

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

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.

Osservazioni

Le DLL del server di monitoraggio delle porte sono necessarie per definire una funzione XcvOpenPort e includerne l'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 una delle 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 un 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 OpenPrintere successivamente ricevuto come argomento di input per XcvDataPort.

La funzione deve salvare la maschera di accesso concessa. Successivamente, quando viene chiamata la funzione di 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.