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

Статья
08/26/2023

Функция lineGetCallStatus возвращает текущее состояние указанного вызова.

Синтаксис

LONG lineGetCallStatus(
  HCALL            hCall,
  LPLINECALLSTATUS lpCallStatus
);

Параметры

hCall

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

lpCallStatus

Указатель на структуру данных изменяющегося размера типа LINECALLSTATUS. После успешного выполнения запроса эта структура заполняется сведениями о состоянии вызова. Перед вызовом lineGetCallStatus приложение должно задать элемент dwTotalSize этой структуры, чтобы указать объем памяти, доступный TAPI для возврата информации.

Примечание Если параметры размера в структуре неверны, существует вероятность того, что данные могут быть перезаписаны. Дополнительные сведения о настройке размеров структуры см. в разделе о выделении памяти .

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

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

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

Функция lineGetCallStatus возвращает динамическое состояние вызова, тогда как lineGetCallInfo возвращает в основном статические сведения о вызове. Сведения о состоянии вызова включают текущее состояние вызова, подробные сведения о режиме, связанные с вызовом в этом состоянии (если таковые имеются), а также список доступных функций API, которые приложение может вызывать при вызове, пока вызов находится в этом состоянии. Приложение обычно заинтересовано в запросе этих сведений, когда оно получает уведомление об изменении состояния звонка в сообщении LINE_CALLSTATE.