Función lineAddProvider (tapi.h)

Artículo
08/26/2023

La función lineAddProvider instala un nuevo proveedor de servicios de telefonía en el sistema de telefonía.

Sintaxis

LONG lineAddProvider(
  LPCSTR  lpszProviderFilename,
  HWND    hwndOwner,
  LPDWORD lpdwPermanentProviderID
);

Parámetros

lpszProviderFilename

Puntero a un

Cadena terminada en null que contiene la ruta de acceso del proveedor de servicios que se va a agregar.

hwndOwner

Controle a una ventana en la que se adjuntarán los cuadros de diálogo que deban mostrarse como parte del proceso de instalación (por ejemplo, por la función TSPI_providerInstall del proveedor de servicios). Puede ser NULL para indicar que cualquier ventana creada durante la función no debe tener ninguna ventana de propietario.

lpdwPermanentProviderID

Puntero a una variable que recibe el identificador de proveedor permanente del proveedor de servicios recién instalado.

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_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOMULTIPLEINSTANCE, LINEERR_OPERATIONFAILED.

Comentarios

Durante esta llamada de función, TAPI comprueba que puede acceder al proveedor de servicios llamando a su función de TSPI_providerInstall ; si esto no se realiza correctamente (si no se encuentra el archivo DLL o la función, o si TSPI_providerInstall devuelve un error), se produce un error en la función y el proveedor no se agrega al sistema de telefonía. Si esto se realiza correctamente y el sistema de telefonía está activo (una o varias aplicaciones han llamado lineInitialize o lineInitializeEx), TAPI no intenta iniciar el proveedor de servicios recién agregado. En su lugar, para activar el nuevo proveedor de servicios, TAPI emite un mensaje para reiniciar Windows. Cuando la activación se realiza correctamente, se informa a las aplicaciones de los nuevos dispositivos creados mediante LINE_CREATE o PHONE_CREATE mensajes, o mediante un mensaje de LINE_LINEDEVSTATE solicitud de reinicialización (si la aplicación no admite los mensajes CREATE).

Esta función no copia ningún archivo, no el propio archivo DLL del proveedor de servicios ni ningún archivo auxiliar; La aplicación que administra la adición del proveedor debe asegurarse de que el proveedor está instalado en un directorio donde tapi lo puede encontrar (por ejemplo, \WINDOWS, \WINDOWS\SYSTEM o en otro lugar de la ruta de acceso).