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

Статья
03/02/2024

Функция lineGetNewCalls возвращает дескрипторы вызовов по указанной строке или адресу, для которых в настоящее время у приложения нет дескрипторов. Приложению предоставляется разрешение монитора для этих вызовов.

Синтаксис

LONG lineGetNewCalls(
  HLINE          hLine,
  DWORD          dwAddressID,
  DWORD          dwSelect,
  LPLINECALLLIST lpCallList
);

Параметры

hLine

Дескриптор к устройству с открытой линией.

dwAddressID

Адрес на данном устройстве с открытой линией. Идентификатор адреса постоянно связан с адресом; идентификатор остается неизменным при обновлении операционной системы.

dwSelect

Выбор запрошенных вызовов. Этот параметр использует одну и только одну из констант LINECALLSELECT_.

lpCallList

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

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

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

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

LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED LINEERR_NOMEM.

Приложение может использовать lineGetNewCalls для получения дескрипторов для вызовов, для которых в настоящее время нет дескрипторов. Приложение может выбрать вызовы, для которых должны возвращаться дескрипторы, основывая этот выбор на область (вызовы по указанной строке или вызовы по указанному адресу). Например, приложение может запрашивать дескрипторы вызовов для всех вызовов по заданному адресу, для которого в настоящее время у него нет дескриптора. Приложению всегда предоставляются права монитора для новых дескрипторов вызовов. Кроме того, при открытии строки приложение использует эту функцию для получения сведения о существующих вызовах.

Приложение может вызывать lineGetCallInfo и lineGetCallStatus для каждого вызова в списке, чтобы определить сведения и состояние вызова соответственно. Он может использовать lineSetCallPrivilege , чтобы изменить свое право на владельца.