Función lineClose (tapi.h)

Artículo
08/26/2023

La función lineClose cierra el dispositivo de línea abierta especificado.

Sintaxis

LONG lineClose(
  HLINE hLine
);

Parámetros

hLine

Controle el dispositivo de línea abierta 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 solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.

Comentarios

Si una aplicación llama a lineClose mientras sigue teniendo llamadas activas en la línea abierta, se revoca la propiedad de estas llamadas de la aplicación. Si la aplicación era el único propietario de estas llamadas, también se quitan las llamadas. Es recomendable que una aplicación elimine las llamadas que posee en una línea abierta al renunciar explícitamente a la propiedad o al quitar estas llamadas antes de cerrar la línea.

Si la línea se cerró correctamente, se envía un mensaje de LINE_LINEDEVSTATE a todas las aplicaciones que supervisan el estado de línea de los cambios abiertos o cerrados. Se suprimen las respuestas asincrónicas pendientes.

Los proveedores de servicios pueden resultar útiles o necesarios para reclamar forzosamente dispositivos de línea desde una aplicación que tenga abierta la línea. Esto puede ser útil para evitar que una aplicación monopolíce el dispositivo de línea durante demasiado tiempo. Si esto sucede, se envía un mensaje LINE_CLOSE a la aplicación, especificando el identificador de línea del dispositivo de línea que se cerró.

La función lineOpen asigna recursos a la aplicación de invocación y se puede impedir que las aplicaciones abran una línea si los recursos no están disponibles. Por lo tanto, una aplicación que solo usa ocasionalmente un dispositivo de línea (por ejemplo, para realizar llamadas salientes) debe cerrar la línea para liberar recursos y permitir que otras aplicaciones abran la línea.