Функция lineProxyMessage (tapi.h)
Функция lineProxyMessage используется зарегистрированным обработчиком запросов прокси-сервера для создания сообщений TAPI, связанных с ее ролью. Например, обработчик агента ACD может использовать эту функцию для создания LINE_AGENTSTATUS сообщений, получаемых всеми приложениями, в которых открыта указанная строка. TAPI подавляет создание сообщения в hLine, указанном в параметрах функции.
Синтаксис
LONG lineProxyMessage(
HLINE hLine,
HCALL hCall,
DWORD dwMsg,
DWORD dwParam1,
DWORD dwParam2,
DWORD dwParam3
);
Параметры
hLine
Дескриптор на устройстве с открытой линией. Эта функция преобразуется с помощью TAPI в правильную строку hLine для каждого приложения, получающего сообщение.
hCall
Если сообщение связано с определенным вызовом (который не является, в случае LINE_AGENTSTATUS), указывает дескриптор обработчика прокси-сервера для этого вызова; для сообщений, не связанных с определенным вызовом, должно быть задано значение NULL . Эта функция преобразуется с помощью TAPI в правильный hCall для каждого приложения, получающего сообщение.
dwMsg
Сообщение TAPI для создания. Это должно быть сообщение, которое разрешено создавать обработчиками прокси-сервера.
dwParam1
Параметр, связанный с отправляемыми сообщениями.
dwParam2
Параметр, связанный с отправляемыми сообщениями.
dwParam3
Параметр, связанный с отправляемыми сообщениями.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно или одно из следующих отрицательных значений ошибки:
LINEERR_INVALLINEHANDLE, LINEERR_INVALCALLHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_NOTREGISTERED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |