función TSPI_providerConfig (tspi.h)
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.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |