Iniciar una sesión

Los elementos principales de información que proporciona una aplicación para iniciar una sesión de comunicaciones son el tipo de dirección, el tipo de medio o los tipos y la dirección de destino.

La dirección de destino puede requerir la traducción de direcciones para colocar la información escrita por un usuario en el formato adecuado para un tipo de dirección determinado. Por ejemplo, un número de teléfono que estaba en una libreta de direcciones electrónicas en formato canónico requerirá la traducción al formato de marcado .

Algunas sesiones pueden requerir parámetros de configuración especiales, si el proveedor de servicios lo admite. Por ejemplo, un TSP de ISDN puede transmitir información del usuario y algunos MSP requieren información sobre la dirección de la secuencia multimedia. Consulte Información de sesión para obtener una revisión de los datos que se pueden establecer o obtener en relación con una sesión.

Una vez iniciada una sesión, TAPI informará al progreso de la llamada mediante el mecanismo de notificación de eventos configurado durante la inicialización.

TAPI 2.x: Las aplicaciones inician una sesión mediante la función lineMakeCall . La función lineTranslateAddress se usa para realizar la traducción de direcciones, si es necesario.

Los parámetros de instalación de llamadas se pueden almacenar en la estructura de datos LINECALLPARAMS y, a continuación, se usa un puntero a esta estructura como parámetro de lineMakeCall. Si no se proporciona ninguna estructura LINECALLPARAMS a lineMakeCall, se solicita una llamada de nivel de voz POTS predeterminada con un conjunto de valores predeterminados.

Si la sesión se configura correctamente, se devuelve un identificador de llamada con privilegios de propietario a la aplicación y TAPI envía los mensajes de la aplicación LINE_CALLSTATE con información sobre el progreso de la llamada. Las aplicaciones suelen usar estos mensajes para mostrar los informes de estado al usuario.

TAPI 3.x: Las aplicaciones inician una sesión de comunicaciones invocando el método ITAddress::CreateCall en una dirección capaz de controlar el tipo de dirección y el tipo de medio necesarios. Si la dirección expone la interfaz ITTerminalSupport , los terminales se seleccionan en las secuencias multimedia del objeto de llamada. Consulte el ejemplo de código Make a Call (Crear un código de llamada) para obtener una ilustración de este proceso.

Los parámetros de instalación de llamadas se pueden almacenar o cambiar mediante métodos expuestos por la interfaz ITCallInfo .

Si la sesión se configura correctamente, TAPI devuelve un puntero de interfaz ITBasicCallControl que se puede usar para más operaciones de sesión o para obtener un puntero de interfaz ITCallInfo que se puede usar para adquirir información adicional de sesión. La interfaz ITCallStateEvent procesa eventos de estado de llamada TAPI.

Nota:

TAPI no debe utilizarse para transmisiones de fax. En su lugar, use las funciones disponibles a través de MAPI, la API de Mensajes de Microsoft.

 

Traducción de direcciones

Una aplicación de servidor o usuario final puede almacenar direcciones en un formato que no sea compatible con las necesidades de un proveedor de servicios determinado. Por ejemplo, un número de teléfono se puede almacenar en una libreta de direcciones electrónicas en formato canónico, pero la mayoría de los proveedores de servicios que controlan los números de teléfono requieren el formato de marcado.

TAPI proporciona operaciones de traducción de direcciones que ayudan a una aplicación a presentar el tipo de dirección correcto a un TSP. El proveedor de servicios especifica a TAPI qué tipos de dirección admite y no necesita incluir ninguna forma de traducción de direcciones.

TAPI 2.x: Consulte lineTranslateAddress.

TAPI 3: Consulte ITAddressTranslation, ITAddressTranslationInfo.

Listas de peaje

En algunas ubicaciones de Norteamérica, todas las llamadas telefónicas realizadas al código de área local son llamadas locales. En otras ubicaciones, algunas llamadas realizadas al código de área local son de larga distancia y necesitan marcar un prefijo "1". Los tres primeros dígitos de la dirección (el prefijo) determinan si una llamada dentro del código de área local es una llamada de pago.

Una lista de peajes es una lista de prefijos en el código de área local cuyas direcciones deben marcarse como direcciones de larga distancia y se evalúan los cargos de larga distancia.

Las listas de peajes no son relevantes para los proveedores de servicios o para las aplicaciones que no acceden a una red telefónica.

TAPI 2.x: Vea lineTranslateAddress (LINETRANSLATERESULT_INTOLLLIST y LINETRANSLATERESULT_NOTINTOLLLIST bits en la estructura LINETRANSLATEOUTPUT ), lineSetTollList.

TAPI 3: Consulte ITAddressTranslation::TranslateAddress, ITAddressTranslationInfo::get_TranslationResults.