Función ConfigurePortUI (winsplp.h)
Una dll de interfaz de usuario del monitor de puertos función ConfigurePortUI 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 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 el usuario no admite la operación o se cancela (seleccionando CANCELAR o seleccionando Aceptar sin cambiar los parámetros de configuración), la función debe llamar a SetLastError(ERROR_CANCELLED) y, a continuación, devolver FALSE.
Observaciones
Los archivos DLL de interfaz de usuario del monitor de puertos son necesarios para definir una función de ConfigurePortUI e incluir la dirección de la función en una estructura monitorUI de.
El administrador de colas del cliente llama ConfigurePortUI desde su función ConfigurePort (que se describe en la documentación del SDK de Microsoft Windows). 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 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 pDatatype y miembros pDevMode pueden ser NULL.
Esta llamada hace que se llame a la función XcvOpenPort 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 XcvClose Port del archivo DLL del servidor.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | winsplp.h (incluya Winsplp.h) |
| biblioteca de | NtosKrnl.exe |