Funzione ConfigurePortUI (winsplp.h)

Articolo
02/27/2024

Una funzione ConfigurePortUI dell'interfaccia utente di monitoraggio della porta ottiene informazioni sulla configurazione della porta dall'utente e la invia alla DLL del server di monitoraggio delle porte.

Sintassi

BOOL WINAPI pfnConfigurePortUI(
  _In_opt_ PCWSTR pszServer,
  _In_     HWND   hWnd,
  _In_     PCWSTR pszPortName
);

Parametri

[in, optional] pszServer

Puntatore fornito dal chiamante a una stringa che rappresenta un nome del server o NULL se la stampante è locale. Il monitoraggio della porta può ignorare questo parametro.

[in] hWnd

Handle fornito dal chiamante della finestra che deve essere usato come padre per le finestre di dialogo. Se NULL, non devono essere visualizzate finestre di dialogo.

[in] pszPortName

Puntatore fornito dal chiamante a una stringa che rappresenta il nome della porta da configurare.

Valore restituito

Se l'operazione ha esito positivo, la funzione deve restituire TRUE. In caso contrario, deve restituire FALSE. Se l'operazione non è supportata o viene annullata dall'utente (selezionando ANNULLA o selezionando OK senza modificare i parametri di configurazione), la funzione deve chiamare SetLastError(ERROR_CANCELLED), quindi restituire FALSE.

Commenti

Le DLL dell'interfaccia utente di monitoraggio delle porte sono necessarie per definire una funzione ConfigurePortUI e includere l'indirizzo della funzione in una struttura MONITORUI .

Lo spooler del client chiama ConfigurePortUI dalla relativa funzione ConfigurePort (descritto nella documentazione di Microsoft Windows SDK). Gli argomenti ricevuti da ConfigurePortUI sono gli argomenti ricevuti da ConfigurePort.

La funzione deve eseguire le operazioni seguenti:

Chiamare OpenPrinter, specificando un nome della stampante con il formato seguente:

\\ServerName\,XcvPortPortName

dove ServerName e PortName sono i nomi del server e delle porte ricevuti come argomenti della funzione ConfigurePortUI .

La chiamata a OpenPrinter richiede una struttura PRINTER_DEFAULTS, descritta nella documentazione di Windows SDK. Il membro DesiredAccess della struttura deve essere impostato su SERVER_ACCESS_ADMINISTER. I membri pDatatype e pDevMode possono essere NULL.

Questa chiamata causa la chiamata alla funzione XcvOpenPort della DLL del server di monitoraggio di stampa.
Ottenere i parametri di configurazione della porta dall'utente visualizzando una finestra di dialogo.
Chiamare XcvData una o più volte, specificando stringhe di nome dati personalizzate, per inviare ogni parametro di configurazione alla DLL del server. Ogni chiamata XcvData causa la chiamata della funzione XcvDataPort del server.
Chiamare ClosePrinter, specificando l'handle ricevuto da OpenPrinter. Ciò causa la chiamata della funzione XcvClosePort della DLL del server.