TUISPI_providerRemove función (tspi.h)

Artículo
08/26/2023

La función TUISPI_providerRemove pide al usuario que confirme la eliminación del proveedor de servicios. Esta función hace que la función TSPI_providerRemove está obsoleta en la versión 2.0 y posteriores (compatible con la versión 1.4 y anteriores).

Es responsabilidad del proveedor de servicios quitar las entradas del Registro que el proveedor de servicios agregó en el momento de addProvider , así como los demás módulos y archivos que ya no son necesarios.

La implementación es opcional.

Sintaxis

LONG TSPIAPI TUISPI_providerRemove(
  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 cualquier ventana de cuadro de diálogo necesaria durante la eliminació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 garantizar que la información definida de forma privada del proveedor de servicios se quite del Registro si devuelve éxito.

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

Se puede llamar a esta función mientras el proveedor de servicios está en uso (es decir, entre TSPI_providerInit y TSPI_providerShutdown). Si esto sucede, el proveedor de servicios debe realizar una combinación adecuada de mostrar un cuadro de diálogo de usuario para anunciar cualquier conflicto y confirmar la eliminación, restringir las opciones de eliminación a las que se pueden realizar de forma transparente, o emitir LINE_CLOSE y PHONE_CLOSE mensajes para informar a TAPI y las aplicaciones de que los dispositivos afectados se han cerrado forzosamente para su eliminación. En cualquier caso, los cambios que afecten al comportamiento visible a través de TSPI solo deben surtir efecto cuando el proveedor de servicios se cierre en el siguiente TSPI_providerShutdown.

Nota Esta función no debe devolver LINEERR_INUSE u otros errores que puedan producirse porque el proveedor está en uso por una aplicación; en su lugar, el proveedor debe conferir al usuario directamente sobre este problema y, a continuación, devolver LINEERR_OPERATIONFAILED si el usuario decide anular la operación.

Este procedimiento se llama solo una vez, en el momento de la eliminación del proveedor de servicios, hasta que haya una llamada a TUISPI_providerInstall.

La función correspondiente en el nivel tapi es lineRemoveProvider. En ese nivel, las aplicaciones esperan tener ya instalados proveedores de servicios; de lo contrario, sus líneas y teléfonos no aparecen dentro de la secuencia disponible de identificadores de dispositivo. El mensaje LINE_CREATE informa a las aplicaciones que se ejecutan sobre la reconfiguración dinámica.