función TSPI_lineCloseCall (tspi.h)

La función TSPI_lineCloseCall desasigna la llamada después de completar o anular todas las operaciones asincrónicas pendientes en la llamada.

Sintaxis

LONG TSPIAPI TSPI_lineCloseCall(
  HDRVCALL hdCall
);

Parámetros

hdCall

Identificador del proveedor de servicios de la llamada que se va a cerrar. Una vez cerrada correctamente la llamada, este identificador ya no es válido. El estado de llamada puede ser cualquier estado.

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 las operaciones asincrónicas. Si se llama a TSPI_lineCloseCall para una llamada en la que hay operaciones asincrónicas pendientes, se debe notificar que las operaciones se completan con un código de error o resultado adecuado antes de que este procedimiento devuelva. Una vez devuelto este procedimiento, el proveedor de servicios no debe notificar ningún evento adicional en la llamada. Los identificadores del proveedor de servicios para la línea y las llamadas en la línea se convierten en "no válidas".

TAPI no llama a TSPI_lineCloseCall si un proveedor de servicios devuelve de forma sincrónica un error de una llamada a la función TSPI_lineMakeCall . Pero TAPI llama a TSPI_lineCloseCall si el proveedor de servicios devuelve un error de la operación asincrónica iniciada por TSPI_lineMakeCall.

Si hay una llamada activa en la línea en el momento de TSPI_lineCloseCall, la llamada debe quitarse si el LINEDEVCAPFLAGS_CLOSEDROP bit indica este comportamiento en la estructura LINEDEVCAPS .

Si el proveedor de servicios puede determinar que hay otro control de uso compartido del agente de la llamada, como en una situación de línea de parte con un teléfono independiente, el proveedor de servicios simplemente permite controlar la llamada pasar al otro agente en lugar de forzar su eliminación.

Esta función siempre debe realizarse correctamente, excepto en circunstancias extraordinarias. La mayoría de los autores de llamadas probablemente omitirán el código de retorno porque no podrán compensar los errores que se produzcan. Los valores devueltos especificados son más avisos para fines de diagnóstico de desarrollo que cualquier otra cosa.

Se llama a esta función cuando la última aplicación con un identificador para esta llamada ejecuta lineDeallocateCall.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tspi.h

Consulte también

LINEDEVCAPS

TSPI_lineMakeCall