Función lineAccept (tapi.h)

Artículo
03/02/2024

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

Sintaxis

LONG lineAccept(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

Parámetros

hCall

Identificador de la llamada que se va a aceptar. La aplicación debe ser propietario de la llamada. El estado de llamada de hCall debe estar ofreciendo.

lpsUserUserInfo

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 aceptación de la llamada. Este puntero se puede dejar 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). El miembro discriminador de protocolo para la información del usuario, si es necesario, debe aparecer como el primer byte del búfer al que apunta lpsUserUserInfo y debe tener en cuenta en dwSize.

dwSize

Tamaño de la información de usuario-usuario en lpsUserUserInfo (incluido el terminador null ), en bytes. Si lpsUserUserInfo es NULL, no se envía información de usuario a la entidad que realiza la llamada y dwSize se omite.

Valor devuelto

Devuelve un identificador de solicitud positivo si la función se completa de forma asincrónica o un número de error negativo si se produce un error. El parámetro dwParam2 del mensaje de LINE_REPLY correspondiente es cero si la función se ejecuta correctamente o es un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED, LINEERR_USERUSERINFOTOOBIG.

Comentarios

La función lineAccept se usa en entornos de telefonía como Integrated Services Digital Network (ISDN) que permiten que las alertas asociadas a las llamadas entrantes sean independientes de la oferta inicial de la llamada. Cuando entra una llamada, se ofrece por primera vez. Durante una pequeña cantidad de tiempo, la aplicación puede tener la opción de rechazar la llamada mediante lineDrop, redirigir la llamada a otra estación mediante lineRedirect, responder a la llamada mediante lineAnswer o aceptar la llamada mediante lineAccept. Después de que una aplicación haya aceptado correctamente una llamada, la alerta comienza tanto en el dispositivo llamado como en el que realiza la llamada y el estado de llamada normalmente pasa a aceptado.

El mensaje de LINE_LINEDEVSTATE notifica la alerta a la aplicación con la indicación de llamada .

La función lineAccept también puede ser compatible con proveedores de servicios que no son ISDN. Otras aplicaciones pueden usar la transición de estado de llamada a aceptada como indicación de que otra aplicación ha reclamado la responsabilidad de la llamada y ha presentado la llamada al usuario.

La aplicación tiene la opción de enviar información del usuario en el momento de la aceptación. Incluso si se envía información de usuario-usuario, no hay ninguna garantía de que la red entregará esta información a la parte que realiza la llamada. Una aplicación debe consultar las funcionalidades del dispositivo de una línea para determinar si la aceptación de llamadas está disponible.