функция TSPI_lineAnswer (tspi.h)

Статья
03/13/2024

Функция TSPI_lineAnswer отвечает на указанный вызов предложения.

Синтаксис

LONG TSPIAPI TSPI_lineAnswer(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

Параметры

dwRequestID

Идентификатор асинхронного запроса.

hdCall

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

lpsUserUserInfo

Указатель на строку, завершающуюся значением NULL, содержащую сведения о пользователе и пользователе, которые должны быть отправлены удаленной стороне во время ответа на вызов. Если этот указатель имеет значение NULL, это означает, что никакие сведения о пользователе не отправляются. Сведения о пользователе отправляются только при поддержке базовой сети (как указано в LINEDEVCAPS).

dwSize

Размер в байтах сведений о пользователе в lpsUserUserInfo. Если параметр lpsUserUserInfo имеет значение NULL, dwSize игнорируется.

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

Возвращает dwRequestID или номер ошибки при возникновении ошибки. Фактический параметр lResult соответствующего ASYNC_COMPLETION равен нулю при успешном выполнении функции или номеру ошибки при возникновении ошибки. Возможные возвращаемые значения:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INUSE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM LINEERR_USERUSERINFOTOOBIG.

При поступлении нового звонка поставщик услуг отправляет TAPI LINE_NEWCALL сообщение для обмена дескрипторами вызова. Поставщик услуг следует за этим с сообщением LINE_CALLSTATE , чтобы сообщить TAPI и его клиентским приложениям о состоянии вызова. Клиентское приложение обычно отвечает на вызов с помощью TSPI_lineAnswer. Как правило, после успешного ответа на вызов вызов переходит в подключенное состояние.

В некоторых средах телефонии (например, ISDN), где оповещения пользователей отделены от предложения звонков, TAPI и его клиентские приложения могут иметь возможность сначала принять звонок перед ответом или вместо этого отклонить или перенаправить предлагаемый звонок.

Если вызов предлагается в момент, когда еще один вызов уже активен, новый вызов подключается к TSPI_lineAnswer. Влияние этого на существующий активный вызов зависит от возможностей устройства линии. Первый вызов может быть не затронут, он может быть автоматически удален или автоматически помещен на удержание. Соответствующие сообщения LINE_CALLSTATE используются для сообщения о переходе состояния в TAPI об обоих вызовах.