функция TSPI_lineSendUserUserInfo (tspi.h)
Функция TSPI_lineSendUserUserInfo отправляет данные пользователя удаленной стороне при указанном вызове.
Синтаксис
LONG TSPIAPI TSPI_lineSendUserUserInfo(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCSTR lpsUserUserInfo,
DWORD dwSize
);
Параметры
dwRequestID
Идентификатор асинхронного запроса.
hdCall
Дескриптор вызова, по которому отправляются сведения о пользователе. Состояние звонка hdCall может быть подключением, предложением, принятым или обратным вызовом.
lpsUserUserInfo
Указатель на строку Юникода, завершающуюся значением NULL, которая содержит сведения о пользователе и пользователе, отправляемые удаленной стороне. Сведения о пользователе отправляются, только если они поддерживаются базовой сетью (см. LINEDEVCAPS).
dwSize
Размер в байтах, включая признак конца null , данных пользователя в lpsUserUserInfo.
Возвращаемое значение
Возвращает dwRequestID или номер ошибки при возникновении ошибки. Фактический параметр lResult соответствующего ASYNC_COMPLETION равен нулю, если функция выполнена успешно, или номер ошибки в случае возникновения ошибки. Возможные возвращаемые значения:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG LINEERR_OPERATIONUNAVAIL.
Комментарии
Эта функция может использоваться для отправки сведений о пользователе в любое время во время подключенного вызова. Если размер отправляемой информации превышает размер одного сетевого сообщения (как в ISDN), поставщик услуг несет ответственность за разбиение информации на последовательность цепочек сетевых сообщений (с использованием "дополнительных данных").
Сведения о пользователе также могут отправляться при принятии звонка, отклонении вызова, перенаправлении звонка и при совершении звонков. Кроме того, можно получать сведения о пользователе. Полученные сведения передаются в структуре ВЫЗОВА LINECALLINFO . Каждый раз, когда информация о пользователе поступает после предложения звонка или перед отключением звонка, LINE_CALLINFO сообщение с параметром UserUserInfo уведомляет TAPI о том, что данные пользователя-пользователя в записи сведений о звонках были изменены. Если несколько сетевых сообщений связаны в цепочку, данные собираются поставщиком услуг и одно сообщение отправляется в TAPI.
Требования
| Целевая платформа | Windows |
| Header | tspi.h |