функция linePrepareAddToConferenceA (tapi.h)

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

Синтаксис

LONG linePrepareAddToConferenceA(
  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.

Заметка

Заголовок tapi.h определяет linePrepareAddToConference как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	tapi.h
библиотеки	Tapi32.lib
DLL	Tapi32.dll

См. также

Обзор конференции

LINECALLPARAMS

LINEDEVSTATUS

LINE_REPLY

дополнительных функций службы

lineAddToConference

lineCompleteTransfer

lineDrop

lineGetLineDevStatus

lineSetupConference

lineSwapHold