Función lineTranslateDialog (tapi.h)

Artículo
03/05/2024

La función lineTranslateDialog muestra un cuadro de diálogo modal de aplicación que permite al usuario cambiar la ubicación actual de un número de teléfono a punto de marcarse, ajustar la ubicación y los parámetros de la tarjeta de llamada y ver el efecto.

Sintaxis

LONG lineTranslateDialog(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  HWND     hwndOwner,
  LPCSTR   lpszAddressIn
);

Parámetros

hLineApp

Identificador de aplicación devuelto por lineInitializeEx. Si una aplicación aún no ha llamado a la función lineInitializeEx , puede establecer el parámetro hLineApp en cero.

dwDeviceID

Identificador de dispositivo para el dispositivo de línea en el que se pretende 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 el dispositivo de línea indicado por dwDeviceID).

hwndOwner

Identificador de una ventana a la que se va a adjuntar el cuadro de diálogo. Puede ser un valor NULL para indicar que cualquier ventana creada durante la función no debe tener ninguna ventana de propietario.

lpszAddressIn

Puntero a una cadena terminada en NULL que contiene un número de teléfono que se usa, en la parte inferior del cuadro de diálogo, para mostrar el efecto de los cambios del usuario en los parámetros de ubicación. El número debe estar en formato canónico; Si no es así, no se muestra la parte del número de teléfono del cuadro de diálogo. Este puntero se puede dejar NULL, en cuyo caso no se muestra la parte del número de teléfono del cuadro de diálogo. Si el parámetro lpszAddressIn contiene un campo de nombre o subaddress, o direcciones adicionales separadas de la primera dirección por caracteres CR y LF, solo se usa la primera dirección en el cuadro de diálogo.

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_INVALPARAM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INVALPOINTER, LINEERR_INIFILECORRUPT, LINEERR_NODRIVER, LINEERR_INUSE, LINEERR_NOMEM, LINEERR_INVALADDRESS, LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED.

Comentarios

En TAPI versión 2.0 o posterior, es posible abrir varias instancias de este cuadro de diálogo. En las versiones de TAPI anteriores a la 2.0, se devuelve LINEERR_INUSE si el cuadro de diálogo ya está mostrado por otra aplicación (no se puede abrir más de una vez). En estas versiones, TAPI lleva el cuadro de diálogo existente al principio y el error indica que no se han controlado los detalles relacionados con la dirección pasada por la aplicación actual, porque la función no procesó esa dirección.

La aplicación debe llamar a lineGetTranslateCaps después de esta función para obtener los cambios realizados por el usuario en los parámetros de traducción de direcciones de telefonía y llamar a lineTranslateAddress para obtener una cadena de marcado basada en las nuevas selecciones del usuario.

Si alguna función relacionada con la traducción de direcciones (por ejemplo, lineGetTranslateCaps o lineTranslateAddress) devuelve LINEERR_INIFILECORRUPT, la aplicación debe llamar a lineTranslateDialog. La función lineTranslateDialog detecta los errores y los corrige, e informa de la acción realizada al usuario.