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

Статья
08/26/2023

Функция lineAgentSpecific позволяет приложению обращаться к собственным функциям обработчика агента, связанным с адресом. Значение расширений зависит от обработчика агента. Каждый набор расширений, связанных с агентом, идентифицируется универсальным уникальным 128-разрядным идентификатором расширения, который должен быть получен вместе со спецификацией расширения от инициатора распространения этого расширения (обычно это автор программного обеспечения обработчика агента на сервере телефонии). Список расширений, поддерживаемых обработчиком агента, получается из структуры LINEAGENTCAPS , возвращаемой lineGetAgentCaps.

Синтаксис

LONG lineAgentSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  DWORD  dwAgentExtensionIDIndex,
  LPVOID lpParams,
  DWORD  dwSize
);

Параметры

hLine

Дескриптор к устройству с открытой линией.

dwAddressID

Адрес на устройстве с открытой линией. Идентификатор адреса постоянно связан с адресом; идентификатор остается неизменным при обновлении операционной системы.

dwAgentExtensionIDIndex

Позиция в структуре ExtensionIDList в LINEAGENTCAPS вызываемого расширения обработчика агента.

lpParams

Указатель на область памяти, используемую для хранения блока параметров. Формат этого блока параметров зависит от устройства, и его содержимое передается TAPI в приложение обработчика агента на сервере телефонии и из него. Этот блок параметров должен указывать вызываемую функцию и включать достаточно места для возвращаемых данных.

dwSize

Размер области блока параметра в байтах.

Примечание Если lpParams является указателем на строку, размер должен включать признак конца NULL .

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

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

LINEERR_INVALADDRESSID, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL LINEERR_UNINITIALIZED.

Дополнительные возвращаемые значения относятся к обработчику агента.

Эта функция предоставляет профиль универсального параметра. Интерпретация структуры параметров зависит от обработчика. Указания и ответы, отправляемые приложению, которые относятся к конкретному обработчику, должны использовать LINE_AGENTSPECIFIC сообщение.

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