función TSPI_lineConfigDialog (tspi.h)

Artículo
03/08/2023

La función TSPI_lineConfigDialog está obsoleta. Los proveedores de servicios TAPI versión 1.4 o anteriores pueden implementar esta función TSPI. TapI versión 2.0 o versiones posteriores de TSP implementan TUISPI_lineConfigDialog.

La función TSPI_lineConfigDialog hace que el proveedor del dispositivo de línea especificado muestre un cuadro de diálogo modal como una ventana secundaria de hwndOwner para permitir al usuario configurar parámetros relacionados con el dispositivo de línea.

Sintaxis

LONG TSPIAPI TSPI_lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

Parámetros

dwDeviceID

Dispositivo de línea que se va a configurar.

hwndOwner

Identificador de una ventana primaria en la que se va a colocar la ventana del cuadro de diálogo.

lpszDeviceClass

Puntero a una cadena Unicode terminada en null que identifica un nombre de clase de dispositivo. Esta clase de dispositivo permite al autor de la llamada seleccionar una subpantalla específica de la información de configuración aplicable a esa clase de dispositivo. Si este parámetro es NULL o una cadena vacía, se debe seleccionar el cuadro de diálogo de configuración de nivel más alto. Las cadenas permitidas son las mismas que para TSPI_lineGetID. Por ejemplo, si la línea admite comm API, pasar comm/datamodem como lpszDeviceClass hace que el proveedor muestre los parámetros relacionados específicamente con Comm (o, al menos, para empezar en el punto correspondiente de una cadena de cuadros de diálogo de configuración de varios niveles, de modo que el usuario no tenga que buscar los parámetros deseados).

Valor devuelto

Devuelve cero si la función se realiza correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:

LINEERR_INUSE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Comentarios

El procedimiento debe actualizar la sección [Telefonía de Windows] en el archivo Win.ini y difundir el mensaje WM_WININICHANGE si realiza cambios en el archivo Telephon.ini que provocaría un cambio en las funcionalidades de línea o dirección notificadas en LINEDEVCAPS o LINEADDRESSCAPS, o si se crea o quita un dispositivo de línea.

No hay ninguna restricción de que se llame a esta función (TSPI_lineConfigDialog) solo cuando se cierra la línea. Sin embargo, cada proveedor puede imponer dicha restricción. Cuando se llama a TSPI_lineConfigDialog , el proveedor podría alertar al usuario con el mensaje "La línea está en uso por una o varias aplicaciones. Es posible que no cambie la configuración de línea mientras la línea esté en uso" (y devuelva el mensaje de error LINEERR_INUSE). Sin embargo, es posible que algunas configuraciones sean seguras para cambiar "sobre la marcha", especialmente aquellas relacionadas con los tipos de medios (como el protocolo de control de errores del módem), especialmente cuando ese tipo de medio no está actualmente en uso. El proveedor podría permitir que esas opciones se cambien mientras la línea está abierta.

No se debe permitir que los usuarios cambien nada que modifique los valores devueltos con LINEDEVCAPS o LINEADDRESSCAPS sin cerrar primero la línea forzosamente como señal de que las aplicaciones deben llamar a funciones que devuelvan estas estructuras para tener información precisa.