Función lineRedirect (tapi.h)

Artículo
03/05/2024

La función lineRedirect redirige la llamada de oferta especificada a la dirección de destino especificada.

Sintaxis

LONG lineRedirect(
  HCALL  hCall,
  LPCSTR lpszDestAddress,
  DWORD  dwCountryCode
);

Parámetros

hCall

Identificador de la llamada que se va a redirigir. La aplicación debe ser propietario de la llamada. El estado de llamada de hCalldebe ofrecerse.

lpszDestAddress

Puntero a la dirección de destino. Esto sigue el formato de número de marcado estándar.

dwCountryCode

Código de país o región de la entidad a la que se redirige la llamada. Si se especifica un valor de 0, la implementación usa un valor predeterminado.

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 realiza correctamente o es un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INVALADDRESS, LINEERR_NOTOWNER, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Comentarios

La redirección de llamadas permite que una aplicación anule la selección de una llamada de oferta a otra dirección sin responder primero a la llamada. La redirección de llamadas difiere del reenvío de llamadas en que el conmutador realiza el reenvío de llamadas sin la participación de la aplicación; El redireccionamiento se puede realizar mediante una llamada por llamada por la aplicación, por ejemplo, controlado por la información del identificador de llamada. Difiere de la transferencia de llamadas en que la transferencia de una llamada requiere que se responda primero a la llamada.

Una vez que se ha redirigido correctamente una llamada, la llamada normalmente pasa a inactiva.

Además de redirigir una llamada entrante, una aplicación puede tener la opción de aceptar la llamada mediante lineAccept, rechazar la llamada mediante lineDrop o responder a la llamada mediante lineAnswer. La disponibilidad de estas operaciones depende de las funcionalidades del dispositivo.