TSPI_providerInstall función (tspi.h)

Artículo
03/13/2024

La función TSPI_providerInstall 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 posterior implementa TUISPI_providerInstall.

La función TSPI_providerInstall instala "partes" adicionales del proveedor en los directorios adecuados (o al menos comprobando que están allí), configura las entradas del Registro del proveedor para sus líneas y teléfonos, y crea cualquier otra entrada necesaria para el proveedor de servicios. Se llama desde la utilidad De telefonía Panel de control (proporcionada con telefonía de Windows en las versiones 1.4 y anteriores) cuando se presiona el botón Agregar.

Sintaxis

LONG TSPIAPI TSPI_providerInstall(
  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 instalación.

dwPermanentProviderID

Identificador de proveedor permanente del proveedor de servicios.

Valor devuelto

Devuelve cero si la función se realiza correctamente o si se produce un error. Los valores devueltos posibles son los siguientes:

LINEERR_OPERATIONFAILED, LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALPARAM.

Comentarios

Esta función completa la instalación de otras partes requeridas por el proveedor de servicios después de que se hayan realizado sus entradas en la sección [Proveedores] del Registro. Si el proveedor de servicios requiere entradas adicionales definidas de forma privada en el registro para que se realicen correctamente, también deben instalarse. Una manera típica de instalar esta sección con sus entradas es llamar a TSPI_providerConfig.

Esta función debe dejar el sistema en un estado coherente. Debe ejecutarse hasta completarse, no permitir que el usuario anule la instalación cuando se complete en parte. Si se produce un error en la instalación, es responsabilidad del proveedor "devolver" lo que se ha hecho y devolver un error. Esto puede implicar el examen previo para comprobar que es posible realizar una instalación completa antes de que comience la instalación.

Esta función se llama solo una vez, durante la instalación del proveedor de servicios, hasta que haya una llamada a TSPI_providerRemove. Se debe llamar a antes de cualquier otra función definida por TSPI.

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 (con requisitos de secuencia externos cumplidos como se describe aquí) cuando se invoca el comando "add". No llama a TSPI_providerConfig para el comando "add".

No hay ninguna función correspondiente en el nivel TAPI. En ese nivel, las aplicaciones esperan tener instalados los proveedores de servicios. Las aplicaciones en ejecución se informan sobre la reconfiguración dinámica a través del valor de LINEDEVSTATE_REINIT o PHONESTATE_REINIT en el mensaje de LINE_LINEDEVSTATE o PHONE_STATE.