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

Статья
08/26/2023

Функция linePrepareAddToConference подготавливает существующий конференц-вызов для добавления другой стороны.

Синтаксис

LONG linePrepareAddToConference(
  HCALL                  hConfCall,
  LPHCALL                lphConsultCall,
  LPLINECALLPARAMS const lpCallParams
);

Параметры

hConfCall

Обработка конференции. Приложение должно быть владельцем этого вызова. Состояние вызова hConfCall должно быть подключено.

lphConsultCall

Указатель на дескриптор HCALL. Затем в это расположение загружается дескриптор, определяющий добавляемый звонок на консультацию. Изначально приложение является единственным владельцем этого вызова.

lpCallParams

Указатель на структуру LINECALLPARAMS , содержащую параметры вызова, используемые при создании консультационного звонка. Для этого параметра можно задать значение NULL , если специальные параметры настройки вызова не требуются.

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

Возвращает положительный идентификатор запроса, если функция выполняется асинхронно, или отрицательный номер ошибки при возникновении ошибки. Параметр dwParam2 соответствующего сообщения LINE_REPLY равен нулю, если функция завершается успешно, или отрицательным номером ошибки при возникновении ошибки. Возможные возвращаемые значения:

LINEERR_BEARERMODEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_CALLUNAVAIL, LINEERR_INVALRATE, LINEERR_CONFERENCEFULL, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_NOTOWNER, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLPARAMS, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCONFCALLHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALLINESTATE, LINEERR_USERUSERINFOTOOBIG LINEERR_INVALMEDIAMODE, LINEERR_UNINITIALIZED.

Если возвращается LINEERR_INVALLINESTATE, строка в настоящее время не находится в состоянии, в котором может быть выполнена эта операция. Список допустимых в настоящее время операций можно найти в элементе dwLineFeatures (типа LINEFEATURE) в структуре LINEDEVSTATUS . (Вызов lineGetLineDevStatus обновляет сведения в LINEDEVSTATUS.)

Дескриптор конференции можно получить с помощью lineSetupConference или lineCompleteTransfer , который разрешается как трехсторонняя конференция. Функция linePrepareAddToConference обычно помещает существующую конференцию в состояние onHoldPendingConference и создает звонок на консультации, который можно добавить позже к существующей конференции с помощью lineAddToConference.

Звонок на консультацию можно отменить с помощью lineDrop. Кроме того, может быть возможно, что приложение может переключиться между консультационным вызовом и проведением конференции с помощью lineSwapHold.