función TUISPI_lineConfigDialog (tspi.h)

Artículo
03/08/2023

La función TUISPI_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. Esta función hace que la función TSPI_lineConfigDialog obsoleta en la versión 2.0 y posteriores (compatible con la versión 1.4 y anteriores).

La implementación es opcional.

Sintaxis

LONG TSPIAPI TUISPI_lineConfigDialog(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  DWORD             dwDeviceID,
  HWND              hwndOwner,
  LPCWSTR           lpszDeviceClass
);

Parámetros

lpfnUIDLLCallback

Puntero a una función a la que el archivo DLL de la interfaz de usuario puede llamar para comunicarse con el archivo DLL del proveedor de servicios para obtener información necesaria para mostrar el cuadro de diálogo y enviar la configuración actualizada al proveedor de servicios.

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 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

No hay ninguna restricción que TUISPI_lineConfigDialog llamar solo cuando se cierra la línea. Sin embargo, cada proveedor puede imponer dicha restricción. Cuando se llama a TUISPI_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, algunas configuraciones pueden ser seguras para cambiar "sobre la marcha", especialmente las relacionadas con los tipos de medios (como el protocolo de control de errores del módem), especialmente cuando ese tipo de medio no está en uso actualmente. 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.