Aggiungere una porta
L'aggiunta di una porta consiste nell'archiviare il nome della porta e le informazioni di configurazione modificabili dall'utente all'interno dell'archiviazione locale della DLL del server di monitoraggio delle porte o nel Registro di sistema.
Quando un'applicazione chiama la funzione AddPort dello spooler di stampa, specifica il nome di un monitoraggio delle porte come argomento della funzione. Lo spooler chiama la funzione AddPortUI contenuta nella DLL dell'interfaccia utente di Monitoraggio porte del monitoraggio delle porte specificato.
La funzione AddPortUI della DLL dell'interfaccia utente di monitoraggio della porta deve eseguire le operazioni seguenti:
Chiamare la funzione OpenPrinter dello spooler di stampa, che fa sì che venga chiamata la funzione XcvOpenPort nella DLL del server di monitoraggio porte.
Chiamare più volte la funzione XcvData dello spooler di stampa per richiedere la DLL del server di monitoraggio delle porte per aggiungere la porta e trasferire le informazioni di configurazione tra la DLL dell'interfaccia utente e la DLL del server. La funzione XcvData chiama la funzione XcvDataPort della DLL del server. La funzione AddPortUI ottiene in genere informazioni di configurazione dall'utente visualizzando le finestre di dialogo.
Chiamare la funzione ClosePrinter dello spooler di stampa, che fa sì che venga chiamata la funzione XcvClosePort nella DLL del server di monitoraggio porte.
Per altre informazioni su queste operazioni, vedere la descrizione di AddPortUI. Vedere anche Archiviazione delle informazioni di configurazione delle porte.
La funzione EnumPorts di un monitor delle porte deve enumerare tutte le porte aggiunte. Lo spooler può chiamare la funzione EnumPorts di ogni monitor delle porte per determinare il set di porte supportate in un server di stampa.