TUISPI_phoneConfigDialog función (tspi.h)
La función TUISPI_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. Esta función hace que la función TSPI_phoneConfigDialog está 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_phoneConfigDialog(
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 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 realiza 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
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 del teléfono.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |