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

Статья
08/26/2023

Функция lineReleaseUserUserInfo информирует поставщика услуг о том, что приложение обработало данные пользователя и пользователя, содержащиеся в структуре LINECALLINFO , и что полученные данные пользователя и пользователя теперь можно записать в нее. Поставщик услуг отправляет LINE_CALLINFO сообщение, указывающее, LINECALLINFOSTATE_USERUSERINFO, когда новые сведения доступны.

Синтаксис

LONG lineReleaseUserUserInfo(
  HCALL hCall
);

Параметры

hCall

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

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

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

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED LINEERR_OPERATIONUNAVAIL.

Функция lineReleaseUserUserInfo позволяет приложению управлять потоком входящих сведений между пользователем и пользователем в подключении ISDN. При получении нового полного сообщения о пользователях поставщик услуг информирует приложение с помощью LINE_CALLINFO сообщения (указывая LINECALLINFOSTATE_USERUSERINFO). Любое количество приложений может проверять сведения (с помощью lineGetCallInfo), но приложение, владеющее вызовом, управляет освобождением информации, чтобы можно было сообщить последующие сведения. Поставщик услуг не будет перезаписывать предыдущие данные пользователя и пользователя в LINECALLINFO новыми сведениями до тех пор, пока не будет вызвана lineReleaseUserUserInfo . Поставщик услуг обязан буферизовать полученные впоследствии сведения о пользователе, пока предыдущие сведения не будут освобождены приложением, владеющим вызовом.