Función ConfigurePortUI (winsplp.h)

Artículo
03/05/2024

Una función ConfigurePortUI del archivo DLL del monitor de puerto obtiene información de configuración de puerto del usuario y la envía al archivo DLL del servidor de supervisión de puertos.

Sintaxis

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

Parámetros

[in, optional] pszServer

Puntero proporcionado por el autor de la llamada a una cadena que representa un nombre de servidor o NULL si la impresora es local. (El monitor de puerto puede omitir este parámetro).

[in] hWnd

Identificador proporcionado por el autor de la llamada de la ventana que se debe usar como elemento primario para los cuadros de diálogo. Si es NULL, no se deben mostrar cuadros de diálogo.

[in] pszPortName

Puntero proporcionado por el autor de la llamada a una cadena que representa el nombre del puerto que se va a configurar.

Valor devuelto

Si la operación se realiza correctamente, la función debe devolver TRUE. De lo contrario, debe devolver FALSE. Si la operación no es compatible o el usuario la cancela (seleccionando CANCELAR o seleccionando Aceptar sin cambiar los parámetros de configuración), la función debe llamar a SetLastError(ERROR_CANCELLED), devolver FALSE.

Comentarios

Los archivos DLL de interfaz de usuario del monitor de puertos son necesarios para definir una función ConfigurePortUI e incluir la dirección de la función en una estructura MONITORUI .

El administrador de colas del cliente llama a ConfigurePortUI desde su función ConfigurePort (descrita en la documentación de Microsoft Windows SDK). Los argumentos recibidos por ConfigurePortUI son los argumentos recibidos por ConfigurePort.

La función debe realizar las siguientes operaciones:

Llame a OpenPrinter y especifique un nombre de impresora con el formato siguiente:

\\ServerName\,XcvPortPortName

donde ServerName y PortName son los nombres de servidor y puerto recibidos como argumentos de función ConfigurePortUI .

La llamada a OpenPrinter requiere una estructura de PRINTER_DEFAULTS, que se describe en la documentación de Windows SDK. El miembro DesiredAccess de la estructura debe establecerse en SERVER_ACCESS_ADMINISTER. Sus miembros pDatatype y pDevMode pueden ser NULL.

Esta llamada hace que se llame a la función XcvOpenPort del archivo DLL del servidor de supervisión de impresión.
Obtenga los parámetros de configuración de puerto del usuario mostrando un cuadro de diálogo.
Llame a XcvData una o varias veces, especificando cadenas de nombre de datos personalizadas, para enviar cada parámetro de configuración al archivo DLL del servidor. Cada llamada XcvData hace que se llame a la función XcvDataPort del servidor.
Llame a ClosePrinter y especifique el identificador recibido de OpenPrinter. Esto hace que se llame a la función XcvClosePort del archivo DLL del servidor.