función TSPI_lineClose (tspi.h)
La función TSPI_lineClose cierra el dispositivo de línea abierta especificado después de completar o anular todas las llamadas pendientes y las operaciones asincrónicas en el dispositivo.
Sintaxis
LONG TSPIAPI TSPI_lineClose(
HDRVLINE hdLine
);
Parámetros
hdLine
Identificador del proveedor de servicios de la línea que se va a cerrar. Una vez cerrada correctamente la línea, este identificador ya no es válido.
Valor devuelto
Devuelve cero si la función se realiza correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL.
Comentarios
El proveedor de servicios debe notificar la finalización de cada operación asincrónica. Si se llama a TSPI_lineClose para una línea en la que hay operaciones asincrónicas pendientes, las operaciones se notifican con un resultado o código de error adecuado antes de que se devuelva este procedimiento.
Existe un requisito similar para las llamadas activas en la línea. Las operaciones pendientes deben notificarse completadas con los códigos de error o resultados adecuados. Las llamadas activas también deben quitarse, si es necesario, y si este comportamiento se indica mediante el bit de LINEDEVCAPFLAGS_CLOSEDROP en la estructura LINEDEVCAPS .
Una vez devuelto este procedimiento, el proveedor de servicios no debe notificar más htCall en la línea o las llamadas que estaban en la línea. Los identificadores del proveedor de servicios para la línea y las llamadas en la línea se convierten en "no válidas".
El proveedor de servicios debe renunciar a recursos no compartidos que se reservan mientras la línea está abierta. Por ejemplo, cerrar una línea a la que se accede a través de un puerto comm y módem debe dar lugar a cerrar el puerto comm, lo que hace que esté disponible una vez más para su uso por otras aplicaciones.
El proveedor de servicios no emite el mensaje LINE_LINEDEVSTATE en respuesta a esta invocación de función porque la línea se cierra y ya no hay ningún interés en sus cambios de estado.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |