функция TSPI_lineCloseCall (tspi.h)
Функция TSPI_lineCloseCall освобождает вызов после завершения или прерывания всех невыполненных асинхронных операций в вызове.
Синтаксис
LONG TSPIAPI TSPI_lineCloseCall(
HDRVCALL hdCall
);
Параметры
hdCall
Дескриптор поставщика услуг для закрываемого вызова. После успешного завершения вызова этот дескриптор становится недействительным. Состояние вызова может быть любым.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL LINEERR_RESOURCEUNAVAIL.
Комментарии
Поставщик услуг должен сообщать о завершении асинхронных операций. Если TSPI_lineCloseCall вызывается для вызова, в котором имеются невыполненные асинхронные операции, перед возвратом этой процедуры следует сообщить о завершении операций с соответствующим результатом или кодом ошибки. После выполнения этой процедуры поставщик услуг должен сообщить о дальнейших событиях в вызове. Дескрипторы поставщика услуг для строки и вызовов в ней становятся недопустимыми.
TAPI не вызывает TSPI_lineCloseCall , если поставщик услуг синхронно возвращает ошибку из вызова функции TSPI_lineMakeCall . Но TAPI вызывает TSPI_lineCloseCall , если поставщик услуг возвращает ошибку из асинхронной операции, инициированной TSPI_lineMakeCall.
Если в строке во время TSPI_lineCloseCall есть активный вызов, вызов должен быть удален, если это поведение указано битом LINEDEVCAPFLAGS_CLOSEDROP в структуре LINEDEVCAPS .
Если поставщик услуг может определить, что имеется другой элемент управления общим доступом к вызову, например в ситуации с линией стороны с отдельным телефоном, поставщик услуг просто позволяет управлять передачей звонка другому агенту, а не принудительно сбрасывать его.
Эта функция всегда должна быть успешной, за исключением чрезвычайных обстоятельств. Большинство вызывающих абонентов, вероятно, проигнорируют код возврата, так как они не смогут компенсировать возникшую ошибку. Указанные возвращаемые значения являются более консультированием для целей диагностики разработки, чем все остальное.
Эта функция вызывается, когда последнее приложение с дескриптором этого вызова выполняет lineDeallocateCall.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |