TUISPI_providerInstall función (tspi.h)

Artículo
03/03/2024

La implementación de la función TUISPI_providerInstall es la oportunidad del proveedor de servicios de instalar "partes" adicionales del proveedor en los directorios adecuados (o al menos comprobar que están allí) y configurar las entradas del Registro que necesita el proveedor. Esta función hace que la función TSPI_providerInstall está obsoleta en la versión 2.0 y posteriores (compatible con la versión 1.4 y anteriores).

Si el proveedor de servicios requiere entradas definidas de forma privada en el Registro para su correcta operación, deben instalarse en este momento.

La implementación es opcional.

Sintaxis

LONG TSPIAPI TUISPI_providerInstall(
  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 la información necesaria para mostrar el cuadro de diálogo.

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 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 puede invocar más de una vez durante la instalación del proveedor de servicios, hasta que haya una llamada a TUISPI_providerRemove. Sin embargo, si el proveedor de servicios no requiere ni admite varias instancias del proveedor, devuelve el LINEERR_ constante LINEERR_NOMULTIPLEINSTANCE .

La función correspondiente en el nivel tapi es lineAddProvider. El mensaje LINE_CREATE informa a las aplicaciones que se ejecutan sobre la reconfiguración dinámica.