Функция lineGetCallInfo (tapi.h)
Функция 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 сообщение о том, что части структуры информации о вызове изменились. Эти сообщения предоставляют дескриптор для вызова в качестве параметра.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |