Función OpenPort (winsplp.h)

Artículo
08/08/2023

La función OpenPort de un monitor de puerto abre un puerto de impresora.

Sintaxis

BOOL OpenPort(
  LPWSTR  pName,
  PHANDLE pHandle
);

Parámetros

pName

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

pHandle

Puntero proporcionado por el autor de la llamada a una ubicación para recibir un identificador de puerto.

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 OpenPort e incluir la dirección de la función en una estructura de MONITOR2 .

Se llama a la función OpenPort , ya sea por un monitor de idioma o por el administrador de trabajos de impresión, cuando se está conectando una cola de impresión a un puerto. El propósito principal de la función OpenPort es devolver un identificador de puerto que el autor de la llamada puede usar como argumento de entrada para las llamadas posteriores a las funciones StartDocPort, WritePort, ReadPort, EndDocPort y GetPrinterDataFromPort del monitor de puerto.

Además de devolver un identificador de puerto, la función OpenPort puede realizar operaciones de inicialización que deben tenerse en cuenta antes de realizar operaciones de lectura o escritura. Por ejemplo, si el puerto admite valores de tiempo de espera modificables, la función OpenPort debe establecer estos valores.

Las llamadas a OpenPort no son específicas del trabajo de impresión. Entre cada llamada a las funciones OpenPort y ClosePort de un monitor de puerto, puede haber varias llamadas a sus funciones StartDocPort y EndDocPort .

Puede suponer que después de que el administrador de trabajos de impresión haya llamado a OpenPort con un nombre de puerto determinado, no llamará a OpenPort de nuevo con el mismo nombre de puerto antes de llamar a ClosePort.

Las funciones de supervisión de impresión que aceptan un identificador de puerto como entrada tampoco aceptan un identificador de monitor. Por lo tanto, la función OpenPort debe almacenar el identificador de monitor recibido en una ubicación a la que puede hacer referencia el identificador de puerto. Esto permite que las funciones que aceptan un identificador de puerto hagan referencia al identificador de monitor.