TSPI_lineAccept función (tspi.h)

Artículo
08/26/2023

La función TSPI_lineAccept acepta la llamada ofrecida especificada. Opcionalmente, puede enviar la información de usuario-usuario especificada a la entidad que llama.

Sintaxis

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

Parámetros

dwRequestID

Identificador de la solicitud asincrónica.

hdCall

Identificador de la llamada que se va a aceptar. El estado de llamada de hdCallpuede ofrecerse.

lpsUserUserInfo

Puntero a una cadena Unicode terminada en null que contiene información de usuario-usuario que se enviará a la parte remota como parte de la aceptación de la llamada. Este puntero es NULL si no se va a enviar información de usuario-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 de usuario-usuario en lpsUserUserInfo. Si lpsUserUserInfo es NULL, dwSize se omite.

Valor devuelto

Devuelve dwRequestID si la función se completa de forma asincrónica o un número de error si se produce un error. El parámetro lResult del ASYNC_COMPLETION correspondiente es 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_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_OPERATIONUNAVAIL.

Comentarios

La función TSPI_lineAccept se usa en entornos de telefonía (como ISDN) que permiten que las alertas asociadas a las llamadas entrantes sean independientes de la oferta inicial de la llamada. Cuando entra en servicio una llamada, la llamada se ofrece por primera vez. Durante un tiempo reducido, la aplicación cliente puede tener la opción de rechazar la llamada mediante TSPI_lineDrop, redirigir la llamada a otra estación mediante TSPI_lineRedirect, responder a la llamada mediante TSPI_lineAnswer o aceptar la llamada mediante TSPI_lineAccept. Después de que se haya aceptado correctamente una llamada, se inician las alertas tanto en el dispositivo llamado como en el que se llama, y normalmente el estado de la llamada pasa al estado aceptado . El proveedor de servicios debe establecer la marca LINEADDRCAPFLAGS_ACCEPTTOALERT en el miembro dwAddrCapFlags de la estructura de datos LINEADDRESSCAPS si la aplicación debe llamar a TSPI_lineAccept para que se inicie la alerta.

Para TAPI, las alertas se notifican mediante el mensaje LINE_LINEDEVSTATE con la indicación de llamada .

TSPI_lineAccept también pueden ser compatibles con proveedores de servicios no ISDN. La transición de estado de llamada al estado aceptado puede ser utilizada por otros de los clientes TAPI como una indicación de que alguna aplicación ha reclamado la responsabilidad de la llamada y ha presentado la llamada al usuario.

La aplicación cliente tiene la opción de enviar información de usuario-usuario en el momento de la aceptación. Incluso si se puede enviar información de usuario-usuario, a menudo no se garantiza que la red entregue esta información a la entidad que realiza la llamada. La aplicación cliente puede consultar las funcionalidades del dispositivo de una línea para determinar si la aceptación de llamadas está disponible.