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

Статья
03/05/2024

Функция lineAccept принимает указанный предлагаемый вызов. При необходимости можно отправить указанные данные пользователя и пользователя вызывающей стороне.

Синтаксис

LONG lineAccept(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

Параметры

hCall

Дескриптор вызова, который будет принят. Приложение должно быть владельцем вызова. Состояние вызова hCall должно быть предложением.

lpsUserUserInfo

Указатель на строку со значением NULL, содержащую сведения о пользователе и пользователе, которые будут отправлены удаленной стороне в рамках приема вызова. Этот указатель можно оставить null , если не нужно отправлять сведения о пользователе. Сведения о пользователе отправляются, только если они поддерживаются базовой сетью (см. lineDEVCAPS). Член дискриминатора протокола для сведений о пользователе и пользователе, если это необходимо, должен отображаться в качестве первого байта буфера, на который указывает lpsUserUserInfo, и должен учитываться в dwSize.

dwSize

Размер сведений пользователя и пользователя в lpsUserUserInfo (включая признак конца null ) в байтах. Если параметр lpsUserUserInfo имеет значение NULL, вызывающей стороне не отправляются никакие сведения о пользователе, а dwSize игнорируется.

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

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

LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED, LINEERR_USERUSERINFOTOOBIG.

Функция lineAccept используется в средах телефонии, таких как интегрированная цифровая сеть (ISDN), которая позволяет отделить оповещения, связанные с входящими вызовами, от первоначального предложения звонка. Когда приходит вызов, он сначала предлагается. В течение некоторого времени приложение может отклонить вызов с помощью lineDrop, перенаправить вызов на другую станцию с помощью lineRedirect, ответить на вызов с помощью lineAnswer или принять вызов с помощью lineAccept. После успешного принятия вызова приложением начинается оповещение как на вызываемом, так и на вызывающем устройстве, и состояние вызова обычно переходит в принятое.

Оповещение сообщается приложению с помощью сообщения LINE_LINEDEVSTATE с указанием звонка .

Функция lineAccept также может поддерживаться поставщиками услуг, не относящихся к ISDN. Переход состояния вызова на accepted может использоваться другими приложениями в качестве признака того, что другое приложение взяло на себя ответственность за вызов и представило вызов пользователю.

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