función TUISPI_providerConfig (tspi.h)
La función TUISPI_providerConfig implementa los elementos de la interfaz de usuario que se deben ejecutar en el contexto de la aplicación que realiza la llamada. Esta función hace que la función TSPI_providerConfig obsoleta en la versión 2.0 y posteriores (compatible con la versión 1.4 y anteriores).
La función TUISPI_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.
La implementación es opcional.
Sintaxis
LONG TSPIAPI TUISPI_providerConfig(
TUISPIDLLCALLBACK lpfnUIDLLCallback,
HWND hwndOwner,
DWORD dwPermanentProviderID
);
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.
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.
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 |