Función lineSetNumRings (tapi.h)

Artículo
03/08/2023

La función lineSetNumRings establece el número de anillos que deben producirse antes de que se responda a una llamada entrante. Esta función se puede usar para implementar una función de estilo toll-saver. Permite que varias aplicaciones independientes registren el número de anillos. La función lineGetNumRings devuelve el número mínimo de anillos solicitados. La aplicación puede usarla que responde a las llamadas entrantes para determinar el número de anillos que debe esperar antes de responder a la llamada.

Sintaxis

LONG lineSetNumRings(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwNumRings
);

Parámetros

hLine

Controle el dispositivo de línea abierta.

dwAddressID

Dirección en el dispositivo de línea. Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.

dwNumRings

Número de anillos antes de que se deba responder una llamada con el fin de respetar las solicitudes de ahorro de peaje de todas las aplicaciones.

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESSID, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Comentarios

Las funciones lineGetNumRings y lineSetNumRings , cuando se usan en combinación, proporcionan un mecanismo para admitir la implementación de características de ahorro de peaje en varias aplicaciones independientes. Si ninguna aplicación llama a lineSetNumRings, lineGetNumRings devuelve 0xFFFFFFFF.

Una aplicación que es el propietario de una llamada en el estado de oferta y que recibió un mensaje de llamadade LINE_LINEDEVSTATE debe esperar un número de anillos igual al número devuelto por lineGetNumRings antes de responder a la llamada para respetar la configuración del protector de peaje en todas las aplicaciones. Se envía un mensaje de llamada LINE_LINEDEVSTATE independiente a la aplicación para cada ciclo de anillo, por lo que la aplicación debe contar estos mensajes. Si esta llamada se desconecta antes de ser contestada y se produce otra llamada poco después, el mensaje de LINE_CALLSTATE debe permitir que la aplicación determine que la llamada está relacionada con la segunda llamada.

Si TAPI realiza la clasificación de llamadas mediante la respuesta a llamadas entrantes de tipo multimedia desconocido y el filtrado de la secuencia de medios, TAPI también respeta este número.

Nota Esta operación es puramente informativa y no afecta al estado de ninguna llamada en el dispositivo de línea.