función TSPI_lineDrop (tspi.h)
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.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | tspi.h |