функция TSPI_lineReleaseUserUserInfo (tspi.h)
Функция TSPI_lineReleaseUserUserInfo сообщает поставщику услуг о том, что информация о пользователе, содержащаяся в структуре LINECALLINFO , была обработана и что полученные впоследствии сведения о пользователе-пользователе теперь могут быть записаны в этой структуре. Поставщик услуг отправляет LINE_CALLINFO сообщение, указывающее, LINECALLINFOSTATE_USERUSERINFO, когда новые сведения доступны.
Синтаксис
LONG TSPIAPI TSPI_lineReleaseUserUserInfo(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall
);
Параметры
dwRequestID
Идентификатор асинхронного запроса.
hdCall
Дескриптор поставщика услуг для вызова, для которого должна быть освобождена информация о пользователе и пользователе. Состояние вызова hdCall может быть любым.
Возвращаемое значение
Возвращает dwRequestID или номер ошибки, если произошла ошибка. Фактический параметр lResult соответствующего ASYNC_COMPLETION равен нулю при успешном выполнении функции или номеру ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL.
Комментарии
Функция TSPI_lineReleaseUserUserInfo позволяет управлять потоком входящих сведений о пользователе в подключении ISDN. При получении нового полного информационного сообщения пользователь-пользователь поставщик услуг информирует TAPI с помощью LINE_CALLINFO сообщения (указывая LINECALLINFOSTATE_USERUSERINFO). Сведения о пользователе и других полях в LINECALLINFO можно проверить с помощью нескольких вызовов TSPI_lineGetCallInfo. Поставщик услуг не должен перезаписывать предыдущие данные пользователя и пользователя в LINECALLINFO новыми сведениями до тех пор, пока не будет вызвана TSPI_lineReleaseUserUserInfo . Поставщик услуг должен буферистить полученные впоследствии сведения о пользователях и пользователях до тех пор, пока не будут освобождены предыдущие сведения. При вызове TSPI_lineCloseCall можно отменить все оставшиеся сведения в буфере.
Если эта функция вызывается, когда в LINECALLINFO нет сведений о пользователе, поставщик услуг тем не менее должен возвращать признаки успешного выполнения.
Для обратной совместимости TAPI автоматически возвращает LINEERR_OPERATIONUNAVAIL, если эта функция вызывается для вызова в строке под контролем поставщика услуг, который не экспортирует функцию.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |