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 traducción de direcciones para poner la información especificada 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ónica en formato canónico requerirá la traducción al formato dialable.

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 de usuario y algunos MSP requieren información sobre la dirección del flujo multimedia. Consulte Información de sesión para obtener una revisión de los datos que se pueden establecer u obtener en relación con una sesión.

Una vez iniciada una sesión, TAPI informará a la aplicación del 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 predeterminada de nivel de voz de POTS 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 LINE _ CALLSTATE de la aplicación con información sobre el progreso de la llamada. Las aplicaciones suelen usar estos mensajes para mostrar 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 los flujos multimedia del objeto de llamada. Vea el ejemplo de código Crear una 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 operaciones de sesión adicionales, o para obtener un puntero de interfaz ITCallInfo que se puede usar para adquirir información de sesión adicional. La interfaz ITCallStateEvent procesa eventos de estado de llamada TAPI.

Nota

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

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ónica en formato canónico, pero la mayoría de los proveedores de servicios que administran 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 direcciones admite y no necesita incluir ninguna forma de traducción de direcciones.

TAPI 2.x: Vea lineTranslateAddress.

TAPI 3: Vea 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 que se marque 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 o no una llamada de peaje.

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

Las listas de peaje no son relevantes para los proveedores de servicios ni para las aplicaciones que no tienen acceso a una red telefónica.

TAPI 2.x: Vea los bits lineTranslateAddress (LINETRANSLATERESULT _ INTOLLLIST y LINETRANSLATERESULT NOTINTOLLLIST en la estructura _ LINETRANSLATEOUTPUT), lineSetTollList.

TAPI 3: Vea ITAddressTranslation::TranslateAddress, ITAddressTranslationInfo::get _ TranslationResults.