функция TSPI_lineAccept (tspi.h)
Функция TSPI_lineAccept принимает указанный предлагаемый вызов. При необходимости можно отправить указанные данные пользователя и пользователя вызывающей стороне.
Синтаксис
LONG TSPIAPI TSPI_lineAccept(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCSTR lpsUserUserInfo,
DWORD dwSize
);
Параметры
dwRequestID
Идентификатор асинхронного запроса.
hdCall
Дескриптор принятого вызова. Состояние вызова hdCall может быть предложением.
lpsUserUserInfo
Указатель на строку Юникода со значением NULL, содержащую сведения о пользователе и пользователе, которые отправляются удаленной стороне в рамках вызова accept. Этот указатель имеет значение NULL , если не требуется отправлять данные пользователя и пользователя. Сведения о пользователе отправляются, только если они поддерживаются базовой сетью (см. lineDEVCAPS).
dwSize
Размер в байтах сведений о пользователе в lpsUserUserInfo. Если параметр lpsUserUserInfo имеет значение NULL, dwSize игнорируется.
Возвращаемое значение
Возвращает dwRequestID , если функция выполняется асинхронно, или номер ошибки при возникновении ошибки. Параметр lResult соответствующего ASYNC_COMPLETION равен нулю при успешном выполнении функции или номеру ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG LINEERR_OPERATIONUNAVAIL.
Комментарии
Функция TSPI_lineAccept используется в средах телефонии (таких как ISDN), которые позволяют отделить оповещения, связанные с входящими вызовами, от первоначального предложения звонка. При вызове сначала предлагается звонок. В течение некоторого времени клиентское приложение может отклонять вызов с помощью TSPI_lineDrop, перенаправлять вызов на другую станцию с помощью TSPI_lineRedirect, отвечать на вызов с помощью TSPI_lineAnswer или принимать вызов с помощью TSPI_lineAccept. После успешного принятия вызова начинается оповещение как на вызываемом, так и на вызывающем устройстве, и обычно состояние вызова переходит в принятое состояние. Поставщик услуг должен задать флаг LINEADDRCAPFLAGS_ACCEPTTOALERT в элементе dwAddrCapFlags структуры данных LINEADDRESSCAPS, если приложение должно вызывать TSPI_lineAccept для начала оповещения.
В TAPI оповещения передаются с помощью сообщения LINE_LINEDEVSTATE с сигнальным сигналом .
TSPI_lineAccept также могут поддерживаться поставщиками служб, не являющихся поставщиками служб ISDN. Переход состояния вызова в принятое состояние может использоваться другими клиентами TAPI как признак того, что какое-то приложение взяло на себя ответственность за вызов и представило вызов пользователю.
Клиентское приложение может отправлять данные пользователя и пользователя во время принятия. Даже если может быть отправлена информация о пользователе, часто не гарантируется, что сеть доставляет эту информацию вызывающей стороне. Клиентское приложение может обратиться к возможностям устройства линии, чтобы определить, доступна ли возможность приема вызова.
Требования
| Целевая платформа | Windows |
| Header | tspi.h |