función TSPI_lineDrop (tspi.h)

Artículo
03/03/2024

La función TSPI_lineDrop quita o desconecta la llamada especificada. Opcionalmente, la información del usuario se puede transmitir como parte de la desconexión de la llamada. La aplicación puede llamar a esta función en cualquier momento. Cuando TSPI_lineDrop devuelve, la llamada debe estar inactiva.

Sintaxis

LONG TSPIAPI TSPI_lineDrop(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

Parámetros

dwRequestID

Identificador de la solicitud asincrónica.

hdCall

Identificador del proveedor de servicios para la llamada que se va a quitar. El estado de llamada de hdCall puede ser cualquier estado excepto inactivo.

lpsUserUserInfo

Este puntero solo es válido si dwSize no es cero. Especifica un puntero a una cadena terminada en null que contiene información de usuario-usuario que se va a enviar a la entidad remota como parte de la desconexión de la llamada. Este puntero es NULL si no se va a enviar información del usuario. La información del usuario solo se envía si es compatible con la red subyacente (consulte LINEDEVCAPS).

dwSize

Tamaño en bytes de la información del usuario en lpsUserUserInfo. Si lpsUserUserInfo es NULL, dwSize se omite.

Valor devuelto

Devuelve dwRequestID o un número de error si se produce un error. El parámetro real lResult del ASYNC_COMPLETION correspondiente es cero si la función se realiza correctamente o si se produce un error. Los valores devueltos posibles son los siguientes:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_OPERATIONUNAVAIL.

Comentarios

El proveedor de servicios devuelve LINEERR_INVALCALLSTATE si el estado actual de la llamada no permite quitar la llamada.

Al invocar TSPI_lineDrop, las llamadas relacionadas a veces también pueden verse afectadas. Por ejemplo, quitar una llamada de conferencia puede quitar todas las llamadas participantes individuales. LINE_CALLSTATE mensajes se envían a TAPI para todas las llamadas cuyo estado de llamada se ve afectado. Normalmente, una llamada eliminada pasa al estado inactivo . Invocar TSPI_lineDrop en una llamada en el estado de la oferta rechaza la llamada. No todas las redes telefónicas proporcionan esta funcionalidad.

En situaciones en las que la llamada que se va a quitar es una llamada de consulta establecida durante el establecimiento de la llamada de transferencia o conferencia, la llamada original que se realizó en el estado OnHoldPending se vuelve a conectar y normalmente vuelve a entrar en el estado de llamada conectado .

TAPI tiene la opción de enviar información del usuario en el momento de la eliminación. Incluso si se puede enviar información de usuario-usuario, no hay ninguna garantía de que la red entregará esta información a la parte remota.

Nota En varias configuraciones de líneas puentedas o de entidad cuando hay varias partes en la llamada, es posible que TSPI_lineDrop no borre realmente la llamada.