Функция lineSecureCall (tapi.h)

Статья
08/26/2023

Функция lineSecureCall защищает вызов от любых прерываний или помех, которые могут повлиять на поток мультимедиа вызова.

Синтаксис

LONG lineSecureCall(
  HCALL hCall
);

Параметры

hCall

Дескриптор вызова для защиты. Приложение должно быть владельцем вызова. Состояние вызова hCall может быть любым.

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

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

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER LINEERR_UNINITIALIZED.

Вызов можно защитить, чтобы избежать помех. Например, в аналоговой среде тон ожидания звонка может разрушить сеанс факса или модема при исходном вызове. Функция lineSecureCall позволяет защитить существующий вызов. Функция lineMakeCall предоставляет возможность защитить вызов с момента настройки вызова. Защита звонка остается в силе в течение всего времени вызова.