функция TSPI_providerShutdown (tspi.h)

Статья
08/26/2023

Функция TSPI_providerShutdown завершает работу поставщика услуг. Поставщик услуг завершает все действия, которые он выполняет, и освобождает все выделенные ресурсы.

Синтаксис

LONG TSPIAPI TSPI_providerShutdown(
  DWORD dwTSPIVersion,
  DWORD dwPermanentProviderID
);

Параметры

dwTSPIVersion

Версия определения TSPI, в которой должна работать эта функция. Вызывающий объект может использовать TSPI_lineNegotiateTSPIVersion или TSPI_phoneNegotiateTSPIVersion со специальным INITIALIZE_NEGOTIATIONdwDeviceID для согласования версии, гарантированно приемлемой для поставщика услуг.

dwPermanentProviderID

Этот параметр позволяет поставщику услуг определить, какой из нескольких возможных экземпляров поставщика службы завершает работу. Значение параметра идентично значению, переданному в параметре с тем же именем в TSPI_providerInit.

Возвращаемое значение

Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM.

Последний сопряженный вызов этой функции должен быть последним вызовом любой из функций TSPI с префиксом TSPI_line или TSPI_phone , отличных от TSPI_lineNegotiateTSPIVersion, или TSPI_phoneNegotiateTSPIVersion. Ответственность за это лежит на звонявом.

Эта функция всегда должна быть успешной, за исключением чрезвычайных обстоятельств. Большинство вызывающих абонентов, вероятно, проигнорируют код возврата, так как они не смогут компенсировать возникшую ошибку. Указанные возвращаемые значения являются более консультированием для целей диагностики разработки, чем все остальное.

В TAPI нет непосредственно соответствующей функции. В TAPI несколько разных экземпляров использования могут быть невыполненными с параметром application handle для определения экземпляра, с которым нужно работать. В TSPI архитектура интерфейса поддерживает только один экземпляр использования для каждого отдельного поставщика услуг.