función TSPI_providerConfig (tspi.h)

Artículo
03/03/2024

La función TSPI_providerConfig 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_providerConfig.

La función TSPI_providerConfig recopila información de configuración del usuario. Puede usar un cuadro de diálogo y este cuadro de diálogo puede incluir subdirecursos asociados a otras API (como Comm/datamodem) para la configuración de dispositivos específicos.

Sintaxis

LONG TSPIAPI TSPI_providerConfig(
  HWND  hwndOwner,
  DWORD dwPermanentProviderID
);

Parámetros

hwndOwner

Identificador de la ventana primaria en la que la función puede crear las ventanas de cuadro de diálogo necesarias durante la configuración.

dwPermanentProviderID

Identificador de proveedor permanente del proveedor de servicios.

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:

LINEERR_OPERATIONFAILED, LINEERR_NOMEM.

Comentarios

Se puede llamar a esta función mientras el proveedor de servicios está en uso (es decir, entre llamadas de TSPI_providerInit y TSPI_providerShutdown).

Los cambios que afecten al comportamiento visible a través de TSPI solo deben surtir efecto cuando el proveedor de servicios se reinicie en el siguiente TSPI_providerInit.

La utilidad de telefonía Panel de control proporcionada con telefonía de Windows en las versiones 1.4 y anteriores llama a esta función cuando se invoca el comando de instalación.

No hay ninguna función correspondiente directamente en el nivel TAPI. En TAPI, las aplicaciones tienen acceso a las funciones lineConfigDialog y phoneConfigDialog, que permiten la configuración de parámetros de una línea o teléfono determinada una vez que se haya instalado.