Función lineRemoveProvider (tapi.h)

Artículo
03/05/2024

La función lineRemoveProvider quita un proveedor de servicios de telefonía existente del sistema de telefonía.

Sintaxis

LONG lineRemoveProvider(
  DWORD dwPermanentProviderID,
  HWND  hwndOwner
);

Parámetros

dwPermanentProviderID

Identificador de proveedor permanente del proveedor de servicios que se va a quitar.

hwndOwner

Identificador de una ventana a la que se adjuntarán todos los cuadros de diálogo que deban mostrarse como parte del proceso de eliminación (por ejemplo, un cuadro de diálogo de confirmación por parte de la función TSPI_providerRemove del proveedor de servicios). Puede ser un valor NULL para indicar que cualquier ventana creada durante la función no debe tener ninguna ventana de propietario.

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALPARAM, LINEERR_OPERATIONFAILED.

Comentarios

Si la llamada a TSPI_providerRemove se realiza correctamente y el sistema de telefonía está activo en el momento, TAPI llama a lineShutdown o phoneShutdown en el proveedor de servicios (dependiendo de los tipos de dispositivo que estén activos). Los identificadores de línea o teléfono que todavía mantienen las aplicaciones en los dispositivos asociados se cierran forzosamente con mensajes de LINE_CLOSE o PHONE_CLOSE (es preferible que los proveedores de servicios emita estos mensajes como parte de TSPI_providerRemove, después de la verificación con el usuario). Los dispositivos previamente bajo el control de ese proveedor se marcan como "no disponibles", de modo que cualquier intento futuro por las aplicaciones de hacer referencia a ellos por identificador de dispositivo da como resultado LINEERR_NODRIVER.