LINEAGENTCAPS 结构 (tapi.h)

项目
08/26/2023

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 版本。这不大于调用应用程序传递给 lineGetAgentCaps 的 API 版本。

dwFeatures

使用 LINEAGENTFEATURE_ 常量可用于此行的代理相关功能。调用受支持的功能需要线路和地址处于正确的状态。位位置中的零表示相应的功能永远不可用。一个指示，如果行处于适当的状态，则相应的功能可能可用，以便使操作有意义。此字段允许应用程序发现哪些代理功能可以 (，哪些代理功能永远不会) 设备支持。

dwStates

LINEAGENTSTATE_可在 lineSetAgentState 的 dwAgentState 参数中使用的常量。设置支持的状态要求行和地址处于正确的状态。位位置中的零表示相应的状态永远不可用。一个指示，如果行处于适当的状态，则相应的状态可能可用，以便状态有意义。此字段允许应用程序发现哪些代理状态可以 (，哪些代理状态永远不会在设备上) 受支持。

dwNextStates

LINEAGENTSTATE_可在 lineSetAgentState 的 dwNextAgentState 参数中使用的常量。设置支持的状态要求行和地址处于正确的状态。位位置中的零表示相应的状态永远不可用。一个指示，如果行处于适当的状态，则相应的状态可能可用，以便状态有意义。此字段允许应用程序发现哪些代理状态可以 (，哪些代理状态永远不会在设备上) 受支持。

dwMaxNumGroupEntries

可以同时登录地址的代理标识符的最大数目。确定作为 LINEAGENTGROUPLIST 结构中的 dwNumEntries 成员传递到 lineSetAgentGroup 的最大值。

dwAgentStatusMessages

指示应用程序可在 dwParam2 中接收LINE_AGENTSTATUS消息的LINEAGENTSTATUS_常量。

dwNumAgentExtensionIDs

ExtensionIDList 数组中显示的 LINEEXTENSIONID 结构的数目。如果地址上支持特定于代理处理程序的扩展，则值为 0。

dwAgentExtensionIDListSize

代理扩展 ID 数组的大小（以字节为单位）。

dwAgentExtensionIDListOffset

从结构开头到 LINEEXTENSIONID 结构数组的偏移量。大小为 dwNumExtensionIDs 乘 SIZEOF (LINEEXTENSIONID) 。数组列出了地址的代理句柄支持的所有代理处理程序特定扩展的 128 位通用唯一标识符。正在使用的扩展在 lineAgentSpecific 函数中被引用，并按其在此表中的位置（第一个条目为条目 0） LINE_AGENTSPECIFIC 消息，因此代理处理程序必须始终按相同的顺序在此数组中显示扩展标识符。数组的大小由 dwAgentExtensionIDListOffset 指定。

ProxyGUID

与行关联的 ACD 代理的 GUID。此元素仅向协商 TAPI 版本 2.2 或更高版本的应用程序公开。