función TSPI_phoneConfigDialog (tspi.h)

La función TSPI_phoneConfigDialog 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 implementa TUISPI_phoneConfigDialog.

La función TSPI_phoneConfigDialog hace que el proveedor del dispositivo telefónico 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 telefónico.

Sintaxis

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

Parámetros

dwDeviceID

Dispositivo telefónico 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 selecciona el cuadro de diálogo de configuración de nivel más alto.

Valor devuelto

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

PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL.

Comentarios

TSPI_phoneConfigDialog hace que el proveedor de servicios muestre un cuadro de diálogo modal como una ventana secundaria de hWndOwner para permitir al usuario configurar parámetros relacionados con el teléfono especificado 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 TSPI_phoneGetID. Por ejemplo, si el teléfono admite la API Comm, 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 en 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). El parámetro szDeviceClass debe ser "tapi/phone", "" o NULL para que el proveedor muestre la configuración de nivel más alto para el teléfono.

El procedimiento debe actualizar la sección [Telefonía de Windows] del archivo Win.ini y difundir el mensaje de WM_WININICHANGE si realiza cambios en Telephon.ini que afectan al contenido de las estructuras visibles para las aplicaciones (como PHONECAPS), o si se crean o quitan dispositivos telefónicos.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tspi.h

Consulte también

PHONECAPS

TSPI_phoneGetID