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

Статья
08/26/2023

Функция lineGetConfRelatedCalls возвращает список дескрипторов вызовов, которые являются частью того же конференц-звонка, что и указанный вызов. Указанный вызов является конференцией или вызовом участника в конференции. Новые дескрипторы создаются для тех вызовов, для которых у приложения еще нет дескрипторов, и приложению предоставляются права мониторинга для этих вызовов.

Синтаксис

LONG lineGetConfRelatedCalls(
  HCALL          hCall,
  LPLINECALLLIST lpCallList
);

Параметры

hCall

Дескриптор вызова. Это либо конференц-звонок, либо вызов участника в конференции. Для родительского вызова конференции состоянием вызова hCall может быть любое состояние. Для звонка участника конференции он должен находиться в состоянии конференции.

lpCallList

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

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

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

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

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

Указанный вызов может быть дескриптором конференц-звонка или дескриптором звонка участника. Например, консультативный звонок, который еще не был добавлен в конференцию, не является частью конференции. Первая запись в возвращаемом списке — это дескриптор конференц-звонка, а остальные — все вызовы участников. Указанный вызов всегда является одним из вызовов, возвращаемых в списке. Вызовам в списке, для которых у приложения еще нет дескриптора вызовов, назначены права монитора; Привилегии для вызовов, для которых у приложения уже есть дескрипторы, не изменяются. Приложение может использовать lineSetCallPrivilege для изменения привилегии вызова.

Если lineGetConfRelatedCalls вызывается сразу после добавления вызова в конференцию с помощью lineCompleteTransfer, функция lineGetConfRelatedCalls может не возвращать полный список связанных вызовов, так как TAPI ожидает получения LINE_CALLSTATE сообщения о том, что звонок поступил LINECALLSTATE_CONFERENCED, прежде чем считать вызов фактически частью конференции (то есть состояние конференции подтверждается поставщиком услуг). Когда приложение получит сообщение LINE_CALLSTATE, функция lineGetConfRelatedCalls возвращает полные сведения.

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