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

Información general de referencia de TAPI 2.2

phoneGetID