Поделиться через

Функция 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

См. также раздел

LINE_AGENTSTATUS

Функции дополнительных линейных служб

Обзор справочника по TAPI 2.2