función TSPI_providerShutdown (tspi.h)

Artículo
03/08/2023

La función TSPI_providerShutdown apaga el proveedor de servicios. El proveedor de servicios finaliza las actividades que tiene en curso y libera los recursos que haya asignado.

Sintaxis

LONG TSPIAPI TSPI_providerShutdown(
  DWORD dwTSPIVersion,
  DWORD dwPermanentProviderID
);

Parámetros

dwTSPIVersion

Versión de la definición de TSPI con la que debe funcionar esta función. El autor de la llamada puede usar TSPI_lineNegotiateTSPIVersion o TSPI_phoneNegotiateTSPIVersion con el INITIALIZE_NEGOTIATIONdwDeviceID especial para negociar una versión que se garantiza que sea aceptable para el proveedor de servicios.

dwPermanentProviderID

Este parámetro permite al proveedor de servicios determinar cuál entre varias instancias posibles del proveedor de servicios se está cerrando. El valor del parámetro es idéntico al que se pasa en el parámetro del mismo nombre en TSPI_providerInit.

Valor devuelto

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

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM.

Comentarios

La última llamada emparejada a esta función debe ser la última llamada a cualquiera de las funciones TSPI prefijos con TSPI_line o TSPI_phone que no sean TSPI_lineNegotiateTSPIVersion o TSPI_phoneNegotiateTSPIVersion. Es responsabilidad del autor de la llamada garantizar esto.

Esta función siempre debe realizarse correctamente, excepto en circunstancias extraordinarias. La mayoría de los autores de llamadas probablemente omitirán el código de retorno porque no podrán compensar los errores que se produzcan. Los valores devueltos especificados son más avisos para fines de diagnóstico de desarrollo que cualquier otra cosa.

No hay ninguna función correspondiente directamente en TAPI. En TAPI, varias instancias de uso diferentes pueden ser pendientes, con un parámetro de "identificador de aplicación" para identificar la instancia en la que se va a operar. En TSPI, la arquitectura de interfaz solo admite una única instancia de uso para cada proveedor de servicios distinto.