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

Статья
08/26/2023

Функция lineGetCallInfo позволяет приложению получать фиксированные сведения о указанном вызове.

Синтаксис

LONG lineGetCallInfo(
  HCALL          hCall,
  LPLINECALLINFO lpCallInfo
);

Параметры

hCall

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

lpCallInfo

Указатель на структуру данных изменчивого размера типа LINECALLINFO. После успешного выполнения запроса эта структура заполняется сведениями, связанными с вызовами. Перед вызовом lineGetCallInfo приложение должно задать член dwTotalSize этой структуры, чтобы указать объем памяти, доступный ДЛЯ TAPI для возврата сведений.

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

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

LINEERR_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED LINEERR_OPERATIONUNAVAIL.

Для каждого входящего или исходящего вызова существует отдельная структура LINECALLINFO . Структура содержит в основном фиксированную информацию о вызове. Обычно приложение заинтересовано в проверке этих сведений, когда оно получает дескриптор вызова LINE_CALLSTATE сообщение или каждый раз, когда оно получает уведомление от LINE_CALLINFO сообщение о том, что части структуры информации о вызове изменились. Эти сообщения предоставляют дескриптор для вызова в качестве параметра.