Función XcvOpenPort (winsplp.h)
Una dll del servidor de supervisión de puertos XcvOpenPort función 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 nully la mayoría de los monitores no necesitan este parámetro.
GrantedAccess
Estructura de ACCESS_MASK proporcionada por el autor de la llamada que contiene el acceso concedido al usuario durante la llamada del ARCHIVO DLL de la interfaz de usuario del monitor de impresión a la función OpenPrinter del autor de la llamada. Consulte la siguiente sección Comentarios.
phXcv
Puntero proporcionado por el autor de la llamada a una ubicación para recibir un identificador 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.
Observaciones
Los archivos DLL del servidor de supervisión de puertos son necesarios para definir una función XcvOpenPort de e incluir su dirección en una estructura de MONITOR2.
La función de OpenPrinter de spooler (descrita en la documentación del SDK de Microsoft Windows) 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 openPrintery, 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 | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | winsplp.h (incluya Winsplp.h) |
| biblioteca de | NtosKrnl.exe |