Структура LINEAGENTCAPS (tapi.h)

Статья
03/05/2024

Структура LINEAGENTCAPS описывает возможности агента ACD. Функция lineGetAgentCaps возвращает структуру LINEAGENTCAPS .

Синтаксис

typedef struct lineagentcaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwAgentHandlerInfoSize;
  DWORD dwAgentHandlerInfoOffset;
  DWORD dwCapsVersion;
  DWORD dwFeatures;
  DWORD dwStates;
  DWORD dwNextStates;
  DWORD dwMaxNumGroupEntries;
  DWORD dwAgentStatusMessages;
  DWORD dwNumAgentExtensionIDs;
  DWORD dwAgentExtensionIDListSize;
  DWORD dwAgentExtensionIDListOffset;
  GUID  ProxyGUID;
} LINEAGENTCAPS, *LPLINEAGENTCAPS;

Члены

dwTotalSize

Общий размер, выделенный для этой структуры данных, в байтах.

dwNeededSize

Размер, необходимый для хранения всей запрошенной информации в байтах.

dwUsedSize

Размер части этой структуры данных, содержащей полезную информацию, в байтах.

dwAgentHandlerInfoSize

Размер сведений об обработчике агента в байтах.

dwAgentHandlerInfoOffset

Смещение от начала структуры к строке, завершаемой значением NULL, указывающей имя, версию или другие идентифицирующие сведения серверного приложения, обрабатывающего запросы агента. Размер строки определяется параметром dwAgentHandlerInfoSize.

dwCapsVersion

Версия TAPI, используемая приложением-обработчиком агента при подготовке содержимого этой структуры. Это не больше версии API, которую вызывающее приложение передало в lineGetAgentCaps.

dwFeatures

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

dwStates

LINEAGENTSTATE_ константы , которые можно использовать в параметре dwAgentStateобъекта lineSetAgentState. Чтобы задать поддерживаемое состояние, строка и адрес должны находиться в правильном состоянии. Ноль в битовой позиции указывает, что соответствующее состояние никогда не доступно. Один указывает, что соответствующее состояние может быть доступно, если строка находится в соответствующем состоянии, чтобы состояние было значимым. Это поле позволяет приложению определить, какие состояния агента могут поддерживаться (а какие никогда не поддерживаются) на устройстве.

dwNextStates

LINEAGENTSTATE_ константы, которые можно использовать в параметре dwNextAgentStateобъекта lineSetAgentState. Чтобы задать поддерживаемое состояние, строка и адрес должны находиться в правильном состоянии. Ноль в битовой позиции указывает, что соответствующее состояние никогда не доступно. Один указывает, что соответствующее состояние может быть доступно, если строка находится в соответствующем состоянии, чтобы состояние было значимым. Это поле позволяет приложению определить, какие состояния агента могут поддерживаться (а какие никогда не поддерживаются) на устройстве.

dwMaxNumGroupEntries

Максимальное количество идентификаторов агентов, которые могут быть одновременно зарегистрированы на адресе. Определяет наибольшее значение, которое может быть передано в качестве члена dwNumEntries в структуре LINEAGENTGROUPLIST в lineSetAgentGroup.

dwAgentStatusMessages

Указывает LINEAGENTSTATUS_ констант , которые могут быть получены приложением в dwParam2сообщения LINE_AGENTSTATUS .

dwNumAgentExtensionIDs

Количество структур LINEEXTENSIONID , отображаемых в массиве ExtensionIDList . Значение равно 0, если в адресе поддерживаются расширения, относящиеся к обработчику агента.

dwAgentExtensionIDListSize

Размер массива идентификаторов расширений агента в байтах.

dwAgentExtensionIDListOffset

Смещение от начала структуры к массиву структур LINEEXTENSIONID . Размер — dwNumExtensionIDs times SIZEOF(LINEEXTENSIONID). Массив содержит 128-разрядные универсальные идентификаторы для всех расширений обработчика агента, поддерживаемых дескриптором агента для адреса. На используемое расширение ссылается функция lineAgentSpecific и LINE_AGENTSPECIFIC сообщение по его позиции в этой таблице, первой записью которой является запись 0, поэтому важно, чтобы обработчик агента всегда предоставлял идентификаторы расширений в этом массиве в том же порядке. Размер массива определяется параметром dwAgentExtensionIDListOffset.

ProxyGUID

GUID для прокси-сервера ACD, связанного со строкой. Этот элемент доступен только для приложений, которые согласовывают TAPI версии 2.2 или более поздней.