Función XcvOpenPort (winsplp.h)
Una función XcvOpenPort del archivo DLL del servidor de supervisión de puertos abre un puerto para las operaciones de configuración.
Sintaxis
BOOL XcvOpenPort(
LPCWSTR pszObject,
ACCESS_MASK GrantedAccess,
PHANDLE phXcv
);
Parámetros
pszObject
Puntero proporcionado por el autor de la llamada a una cadena que representa el nombre del puerto. Puede ser NULL y la mayoría de los monitores no necesitan este parámetro.
GrantedAccess
El autor de la llamada proporciona ACCESS_MASK estructura que contiene el acceso concedido al usuario durante la llamada de la DLL de interfaz de usuario del monitor de impresión a la función OpenPrinter del administrador de trabajos. Consulte la siguiente sección Comentarios.
phXcv
Puntero proporcionado por el autor de la llamada a una ubicación para recibir un controlador de puerto proporcionado por la función.
Valor devuelto
Si la operación se realiza correctamente, la función debe devolver TRUE. De lo contrario, debe devolver FALSE.
Comentarios
Los archivos DLL del servidor de supervisión de puertos son necesarios para definir una función XcvOpenPort e incluir su dirección en una estructura de MONITOR2 .
La función OpenPrinter de spooler (descrita en la documentación de Microsoft Windows SDK) llama a XcvOpenPort si el nombre de impresora especificado incluye cualquiera de las cadenas "XcvPort" o "XcvMonitor". Para obtener más información, vea AddPortUI.
La función XcvOpenPort debe abrir el puerto con fines de configuración. Esta operación solo puede constar de almacenar los argumentos de entrada para su uso posterior en XcvDataPort. La función debe devolver un identificador a la información almacenada en la ubicación a la que apunta phXcv. Este identificador se devuelve al autor de la llamada de OpenPrinter y, posteriormente, se recibe como argumento de entrada para XcvDataPort.
La función debe guardar la máscara de acceso concedida. Más adelante, cuando se llama a la función XcvDataPort del archivo DLL del servidor, se debe comparar el acceso concedido con SERVER_ACCESS_ADMINISTER y, si se produce un error en la comparación, XcvDataPort debe devolver ERROR_ACCESS_DENIED.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | winsplp.h (incluya Winsplp.h) |
| Library | NtosKrnl.exe |