Función lineTranslateAddress (tapi.h)

Artículo
08/26/2023

La función lineTranslateAddress convierte la dirección especificada en otro formato.

Sintaxis

LONG lineTranslateAddress(
  HLINEAPP              hLineApp,
  DWORD                 dwDeviceID,
  DWORD                 dwAPIVersion,
  LPCSTR                lpszAddressIn,
  DWORD                 dwCard,
  DWORD                 dwTranslateOptions,
  LPLINETRANSLATEOUTPUT lpTranslateOutput
);

Parámetros

hLineApp

Identificador devuelto por lineInitializeEx. Si una aplicación TAPI 2.x aún no ha llamado a la función lineInitializeEx , puede establecer este parámetro en NULL. Las aplicaciones tapi 1.4 deben llamar primero a lineInitialize .

dwDeviceID

Identificador de dispositivo del dispositivo de línea en el que se va a marcar la llamada, de modo que se puedan aplicar variaciones en los procedimientos de marcado en diferentes líneas al proceso de traducción.

dwAPIVersion

Versión más alta de TAPI compatible con la aplicación (no necesariamente el valor negociado por lineNegotiateAPIVersion en algún dispositivo de línea determinado).

lpszAddressIn

Puntero a una cadena terminada en null que contiene la dirección de la información que se va a extraer para la traducción. Debe estar en el formato de dirección canónica o en una cadena arbitraria de dígitos marcados (no canónicos). Este parámetro no debe ser NULL. Si addressIn contiene un campo de nombre o subaddress, o direcciones adicionales separadas de la primera dirección por caracteres CR y LF, solo se traduce la primera dirección.

dwCard

Tarjeta de crédito que se va a usar para marcar. Este parámetro solo es válido si el bit CARDOVERRIDE se establece en dwTranslateOptions. Este parámetro especifica el identificador permanente de una entrada card en la sección [Cards] del Registro (como se obtiene de lineTranslateCaps) que se debe usar en lugar del PreferredCardID especificado en la definición de CurrentLocation. No hace que se modifique el parámetro PreferredCardID de la entrada Location actual en el Registro; la invalidación solo se aplica a la operación de traducción actual. Este parámetro se omite si el bit CARDOVERRIDE no está establecido en dwTranslateOptions.

dwTranslateOptions

Las operaciones asociadas que se realizarán antes de la traducción de la dirección en una cadena de marcado. Este parámetro usa una de las constantes de LINETRANSLATEOPTION_.

Si ha establecido el bit de LINETRANSLATEOPTION_CANCELCALLWAITING, también es aconsejable establecer el bit LINECALLPARAMFLAGS_SECURE en el miembro dwCallParamFlags de la estructura LINECALLPARAMS (pasado a lineMakeCallCall a través del parámetro lpCallParams ). Esto impide que el dispositivo de línea use dígitos marcados para suprimir las interrupciones de llamadas.

lpTranslateOutput

Puntero a un área de memoria asignada por la aplicación para contener la salida de la operación de traducción, de tipo LINETRANSLATEOUTPUT. Antes de llamar a lineTranslateAddress, la aplicación debe establecer el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.

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_BADDEVICEID, LINEERR_INVALPOINTER, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NODRIVER, LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCARD, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPARAM.