función TUISPI_providerConfig (tspi.h)

Artículo
03/03/2024

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.