Función lineConfigDialog (tapi.h)

Artículo
03/13/2024

La función lineConfigDialog hace que el proveedor del dispositivo de línea especificado muestre un cuadro de diálogo (asociado a hwndOwner de la aplicación) para permitir al usuario configurar parámetros relacionados con el dispositivo de línea.

Sintaxis

LONG lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

Parámetros

dwDeviceID

Identificador del dispositivo de línea que se va a configurar.

hwndOwner

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

lpszDeviceClass

Puntero a una cadena terminada en null que identifica un nombre de clase de dispositivo. Esta clase de dispositivo permite a la aplicación seleccionar una subpantalla específica de la información de configuración aplicable a esa clase de dispositivo. Este parámetro es opcional y se puede dejar NULL o vacío, en cuyo caso se selecciona la configuración de nivel más alto.

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_NOMEM, LINEERR_INUSE, LINEERR_OPERATIONFAILED, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPARAM, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.

Comentarios

La función lineConfigDialog hace que el proveedor de servicios muestre un cuadro de diálogo modal (asociado a hwndOwner de la aplicación) para permitir al usuario configurar parámetros relacionados con la línea especificada por dwDeviceID. El parámetro lpszDeviceClass permite a la aplicación seleccionar una subpantalla específica de información de configuración aplicable a la clase de dispositivo en la que está interesado el usuario; las cadenas permitidas son las mismas que para lineGetID. Por ejemplo, si la línea admite la API Comm, pasar "COMM" como lpszDeviceClass hace que el proveedor muestre los parámetros relacionados específicamente con Comm (o, al menos, comience en el punto correspondiente en una cadena de cuadros de diálogo de configuración de varios niveles, por lo que el usuario no tiene que "cavar" para buscar los parámetros de interés).

El parámetro lpszDeviceClass sería "tapi/line", "" o NULL para hacer que el proveedor muestre la configuración de nivel más alto para la línea.