Función lineTranslateDialogA (tapi.h)
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.
LONG lineTranslateDialogA(
HLINEAPP hLineApp,
DWORD dwDeviceID,
DWORD dwAPIVersion,
HWND hwndOwner,
LPCSTR lpszAddressIn
);
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 procedimientos de marcado en diferentes líneas al proceso de traducción.
dwAPIVersion
La versión más alta de TAPI admitida por 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 un cadena terminadanull 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 escanonico, 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.
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.
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 otra aplicación ya muestra el cuadro de diálogo (no se puede abrir más de una vez). En estas versiones, TAPI lleva el cuadro de diálogo existente al frente 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.
Nota
El encabezado tapi.h define lineTranslateDialog como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisito | Valor |
---|---|
de la plataforma de destino de |
Windows |
encabezado de |
tapi.h |
biblioteca de |
Tapi32.lib |
DLL de |
Tapi32.dll |
referencia de servicios de telefonía básica de