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

Статья
08/26/2023

Функция lineSendUserUserInfo отправляет данные пользователя и пользователя удаленной стороне при указанном вызове.

Синтаксис

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

Параметры

hCall

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

lpsUserUserInfo

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

dwSize

Размер сведений о пользователе в lpsUserUserInfo в байтах.

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

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

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

Эту функцию можно использовать для отправки сведений о пользователе-пользователе в любое время во время подключенного вызова. Если размер отправляемой информации превышает размер, который может поместиться в одно сетевое сообщение (как в ISDN), поставщик услуг отвечает за разделение информации на последовательность сетевых сообщений в цепочке (с использованием "больше данных").

Сведения о пользователе также могут отправляться при приеме звонка, отклонении вызова и перенаправлении звонка, а также при выполнении вызовов. Кроме того, можно получить сведения о пользователях. Полученные сведения доступны через запись о вызове. Всякий раз, когда информация о пользователе поступает после предложения вызова или перед отключением звонка, LINE_CALLINFO сообщение с параметром UserUserInfo уведомляет приложение о том, что данные пользователя и пользователя в записи сведений о вызове изменились. Если несколько сетевых сообщений связаны в цепочку, данные собираются поставщиком услуг и одно сообщение отправляется в приложение.

Эта функция может отправлять данные по сети в незашифрованном виде; Таким образом, кто-то прослушивает в сети, может быть в состоянии прочитать данные. Перед использованием этого метода следует учитывать риск безопасности при отправке данных в виде чистого текста.