сообщение LINE_PROXYREQUEST
Сообщение LINE_PROXYREQUEST TAPI доставляет запрос зарегистрированным обработчику функции прокси-сервера.
Параметры
-
hDevice
-
Дескриптор приложения к устройству линии, на котором изменилось состояние агента.
-
dwCallbackInstance
-
Экземпляр обратного вызова, указанный при открытии строки вызова.
-
dwParam1
-
Указатель на структуру LINEPROXYREQUEST , содержащую запрос, обрабатываемый приложением обработчика прокси-сервера.
-
dwParam2
-
Зарезервировано.
-
dwParam3
-
Зарезервировано.
Возвращаемое значение
Нет возвращаемого значения.
Комментарии
Сообщение LINE_PROXYREQUEST отправляется только первому приложению, которое зарегистрировано для обработки запросов прокси-сервера доставляемого типа.
Приложение должно обработать запрос, содержащийся в буфере прокси-сервера, и вызвать lineProxyResponse , чтобы вернуть данные или доставить результаты. Обработка запроса должна выполняться в контексте функции обратного вызова TAPI приложения, только если ее можно выполнить немедленно, не дожидаясь ответа от какой-либо другой сущности. Если приложению необходимо взаимодействовать с другими сущностями (например, поставщиком услуг для обработки ACD на основе УАТС или любой другой системной службой, которая может привести к блокировке), запрос должен быть помещен в очередь в приложении и функция обратного вызова завершена, чтобы избежать задержки получения дальнейших сообщений TAPI приложением.
На момент доставки LINE_PROXYREQUEST обработчику прокси-сервера TAPI уже вернул положительный результат функции dwRequestID исходному приложению и разблокировал вызывающий поток, чтобы продолжить выполнение. Приложение ожидает LINE_REPLY сообщение, которое автоматически создается, когда приложение обработчика прокси-сервера вызывает lineProxyResponse.
Приложение не должно освобождать память, на которую указывает lpProxyRequest. TAPI освобождает память во время выполнения lineProxyResponse. Приложение может вызывать lineProxyResponse ровно один раз для каждого сообщения LINE_PROXYREQUEST .
Если приложение получает сообщение LINE_CLOSE при наличии ожидающих запросов прокси-сервера, оно должно вызывать lineProxyResponse для каждого ожидающего запроса, передав соответствующее значение dwResult (например, LINEERR_OPERATIONFAILED).
Требования
| Требование | Значение |
|---|---|
| Версия TAPI |
Требуется TAPI 2.0 или более поздней версии |
| Заголовок |
|