Función phoneConfigDialog (tapi.h)
La función phoneConfigDialog hace que el proveedor del dispositivo telefónico especificado muestre un cuadro de diálogo modal (adjunto al parámetro hwndOwner de la aplicación) que permite al usuario configurar parámetros relacionados con el dispositivo telefónico especificado por dwDeviceID.
Sintaxis
LONG phoneConfigDialog(
DWORD dwDeviceID,
HWND hwndOwner,
LPCSTR lpszDeviceClass
);
Parámetros
dwDeviceID
Identificador del dispositivo telefónico que se va a configurar.
hwndOwner
Identificador de una ventana a la que se va a adjuntar el cuadro de diálogo. Puede ser un valor 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 subscreen 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:
PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.
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 phoneGetID. Por ejemplo, si el teléfono admite la API de onda, pasar "wave/in" como lpszDeviceClass provocaría que el proveedor muestre los parámetros relacionados específicamente con la onda (o al menos para empezar en el punto correspondiente en una cadena de cuadros de diálogo de configuración de varios niveles, lo que elimina la necesidad de buscar parámetros relevantes).
El parámetro lpszDeviceClass debe ser "tapi/phone", "" o NULL para que el proveedor muestre la configuración de nivel más alto para el teléfono.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi.h |
| Library | Tapi32.lib |
| Archivo DLL | Tapi32.dll |
Consulte también
Funciones complementarias del servicio telefónico