通过

LINEPROXYREQUEST 结构 (tapi.h)

  • 项目

LINEPROXYREQUEST 结构包含发出代理请求的应用程序的参数值。 多个 TAPI 呼叫中心函数生成引用 LINEPROXYREQUEST 结构的LINE_PROXYREQUEST消息。

语法

typedef struct lineproxyrequest_tag {
  DWORD dwSize;
  DWORD dwClientMachineNameSize;
  DWORD dwClientMachineNameOffset;
  DWORD dwClientUserNameSize;
  DWORD dwClientUserNameOffset;
  DWORD dwClientAppAPIVersion;
  DWORD dwRequestType;
  union {
    struct {
      DWORD              dwAddressID;
      LINEAGENTGROUPLIST GroupList;
    } SetAgentGroup;
    struct {
      DWORD dwAddressID;
      DWORD dwAgentState;
      DWORD dwNextAgentState;
    } SetAgentState;
    struct {
      DWORD dwAddressID;
      DWORD dwActivityID;
    } SetAgentActivity;
    struct {
      DWORD         dwAddressID;
      LINEAGENTCAPS AgentCaps;
    } GetAgentCaps;
    struct {
      DWORD           dwAddressID;
      LINEAGENTSTATUS AgentStatus;
    } GetAgentStatus;
    struct {
      DWORD dwAddressID;
      DWORD dwAgentExtensionIDIndex;
      DWORD dwSize;
      BYTE  Params[1];
    } AgentSpecific;
    struct {
      DWORD                 dwAddressID;
      LINEAGENTACTIVITYLIST ActivityList;
    } GetAgentActivityList;
    struct {
      DWORD              dwAddressID;
      LINEAGENTGROUPLIST GroupList;
    } GetAgentGroupList;
    struct {
      HAGENT hAgent;
      DWORD  dwAgentIDSize;
      DWORD  dwAgentIDOffset;
      DWORD  dwAgentPINSize;
      DWORD  dwAgentPINOffset;
    } CreateAgent;
    struct {
      HAGENT hAgent;
      DWORD  dwAgentState;
      DWORD  dwNextAgentState;
    } SetAgentStateEx;
    struct {
      HAGENT hAgent;
      DWORD  dwMeasurementPeriod;
    } SetAgentMeasurementPeriod;
    struct {
      HAGENT        hAgent;
      LINEAGENTINFO AgentInfo;
    } GetAgentInfo;
    struct {
      HAGENTSESSION hAgentSession;
      DWORD         dwAgentPINSize;
      DWORD         dwAgentPINOffset;
      HAGENT        hAgent;
      GUID          GroupID;
      DWORD         dwWorkingAddressID;
    } CreateAgentSession;
    struct {
      HAGENT               hAgent;
      LINEAGENTSESSIONLIST SessionList;
    } GetAgentSessionList;
    struct {
      HAGENTSESSION        hAgentSession;
      LINEAGENTSESSIONINFO SessionInfo;
    } GetAgentSessionInfo;
    struct {
      HAGENTSESSION hAgentSession;
      DWORD         dwAgentSessionState;
      DWORD         dwNextAgentSessionState;
    } SetAgentSessionState;
    struct {
      GUID          GroupID;
      LINEQUEUELIST QueueList;
    } GetQueueList;
    struct {
      DWORD dwQueueID;
      DWORD dwMeasurementPeriod;
    } SetQueueMeasurementPeriod;
    struct {
      DWORD         dwQueueID;
      LINEQUEUEINFO QueueInfo;
    } GetQueueInfo;
    struct {
      LINEAGENTGROUPLIST GroupList;
    } GetGroupList;
  };
} LINEPROXYREQUEST, *LPLINEPROXYREQUEST;

成员

dwSize

TAPI 分配的包含 LINEPROXYREQUEST 结构的字节总数。 LINEPROXYREQUEST 中包含的任何结构的 dwTotalSize 成员 (例如 LINEAGENTCAPS) 仅反映为该特定结构分配的字节数。 Params 参数块的总大小（以字节为单位）。

dwClientMachineNameSize

客户端计算机名称字符串的大小（以字节为单位），包括 null 终止符。

dwClientMachineNameOffset

从 结构开头到标识发出此请求的客户端计算机的 以 null 结尾的字符串的偏移量。 字符串的大小由 dwClientMachineNameSize 指定。

dwClientUserNameSize

客户端用户名字符串的大小（以字节为单位），包括 null 终止字符。

dwClientUserNameOffset

从 结构的开头偏移到以 null 结尾的字符串，用于标识在客户端计算机上运行应用程序时使用其帐户的用户。 字符串的大小由 dwClientUserNameSize 指定。

dwClientAppAPIVersion

发出请求的应用程序支持的最高 API 版本。 代理处理程序应将返回到应用程序的任何数据的内容限制为在此或早期版本的 TAPI 中定义的那些成员和值。

dwRequestType

LINEPROXYREQUEST_常量之一。 标识函数的类型以及定义结构中剩余数据的联合组件。

SetAgentGroup

LINEPROXYREQUEST_SETAGENT dwRequestType 时使用的联合组件。

SetAgentGroup.dwAddressID

要为其设置代理的地址的标识符。

SetAgentGroup.GroupList

LINEAGENTGROUPLIST 类型的结构。 此结构中的偏移量相对于 SetAgentGroup.GroupList 的开头，而不是 LINEPROXYREQUEST 结构的开头。

SetAgentState

LINEPROXYREQUEST_SETAGENTSTATE dwRequestType 时使用的联合组件。

SetAgentState.dwAddressID

要为其设置代理状态的地址的标识符。

SetAgentState.dwAgentState

新代理状态，或为零以保持代理状态不变。

SetAgentState.dwNextAgentState

新建下一个代理状态，或零使用与指定代理状态关联的默认下一个状态。

SetAgentActivity

LINEPROXYREQUEST_SETAGENTACTIVITY dwRequestType 时使用的联合组件。

SetAgentActivity.dwAddressID

要为其设置代理活动的地址的标识符。

SetAgentActivity.dwActivityID

所选活动的标识符。

GetAgentCaps

LINEPROXYREQUEST_GETAGENTCAPS dwRequestType 时使用的联合组件。

GetAgentCaps.dwAddressID

要为其检索代理功能的地址的标识符。

GetAgentCaps.AgentCaps

LINEAGENTCAPS 类型的结构。 此结构中的偏移量相对于 GetAgentCaps.AgentCaps 的开头，而不是 LINEPROXYREQUEST 结构的开头。 dwTotalSize 成员由 TAPI 设置，其余字节设置为零。 在调用 lineProxyResponse 之前，代理处理程序必须根据需要填写 dwNeedSize、dwUsedSize 和其余成员。

GetAgentStatus

LINEPROXYREQUEST_SETAGENTGROUP dwRequestType 时使用的联合组件。

GetAgentStatus.dwAddressID

要为其检索代理状态的地址的标识符。

GetAgentStatus.AgentStatus

LINEAGENTSTATUS 类型的结构。 此结构中的偏移量相对于 GetAgentStatus.AgentStatus 的开头，而不是 LINEPROXYREQUEST 结构的开头。 dwTotalSize 成员由 TAPI 设置，其余字节设置为零。 在调用 lineProxyResponse 之前，代理处理程序必须根据需要填写 dwNeedSize、dwUsedSize 和其余成员。

AgentSpecific

LINEPROXYREQUEST_AGENTSPECIFIC dwRequestType 时使用的联合组件。

AgentSpecific.dwAddressID

要为其检索代理状态的地址的标识符。

AgentSpecific.dwAgentExtensionIDIndex

正在调用的处理程序扩展的索引;在 LINEAGENTCAPS 中返回的扩展标识符数组中标识符的位置。

AgentSpecific.dwSize

Params 参数块的总大小（以字节为单位）。

AgentSpecific.Params[1]

包含从应用程序传递到处理程序的内容的内存块。 如果处理程序将数据返回给应用程序，则必须在调用 lineProxyResponse 之前将其写入此参数块。

GetAgentActivityList

LINEPROXYREQUEST_GETAGENTACTIVITYLIST dwRequestType 时使用的联合组件。

GetAgentActivityList.dwAddressID

要为其检索代理活动列表的地址的标识符。

GetAgentActivityList.ActivityList

LINEAGENTACTIVITYLIST 类型的结构。 此结构中的偏移量相对于 GetAgentActivityList.ActivityList 的开头，而不是 LINEPROXYREQUEST 结构的开头。 dwTotalSize 成员由 TAPI 设置，其余字节设置为零。 在调用 lineProxyResponse 之前，代理处理程序必须根据需要填写 dwNeedSize、dwUsedSize 和其余成员。

GetAgentGroupList

LINEPROXYREQUEST_GETAGENTGROUPLIST dwRequestType 时使用的联合组件。

GetAgentGroupList.dwAddressID

要检索代理组列表的地址的标识符。

GetAgentGroupList.GroupList

LINEAGENTGROUPLIST 类型的结构。 此结构中的偏移量相对于 GetAgentGroupList.GroupList 的开头，而不是 LINEPROXYREQUEST 结构的开头。 dwTotalSize 成员由 TAPI 设置，其余字节设置为零。 在调用 lineProxyResponse 之前，代理处理程序必须根据需要填写 dwNeedSize、dwUsedSize 和其余成员。

CreateAgent

LINEPROXYREQUEST_CREATEAGENT dwRequestType 时使用的联合组件。

CreateAgent.hAgent

代理的唯一标识符。 代理处理程序负责生成和维护此标识符的唯一性。

CreateAgent.dwAgentIDSize

代理 ID 字符串的大小（以字节为单位）。

CreateAgent.dwAgentIDOffset

从 结构的开头偏移到以 null 结尾的字符串，该字符串指定代理的 ID。 字符串的大小由 dwAgentIDSize 指定。

CreateAgent.dwAgentPINSize

PIN 字符串的大小（包括 null 终止符），以字节为单位。

CreateAgent.dwAgentPINOffset

从 结构的开头偏移到以 null 结尾的字符串，该字符串指定代理的 PIN 或密码。 字符串的大小由 dwAgentPINSize 指定。

SetAgentStateEx

LINEPROXYREQUEST_SETAGENTSTATEEX dwRequestType 时使用的联合组件。

SetAgentStateEx.hAgent

代理的唯一标识符。 代理处理程序负责生成和维护此标识符的唯一性。

SetAgentStateEx.dwAgentState

LINEAGENTSTATEEX_常量之一。

SetAgentStateEx.dwNextAgentState

LINEAGENTSTATEEX_常量之一。

SetAgentMeasurementPeriod

LINEPROXYREQUEST_SETAGENTMEASUREMENTPERIOD dwRequestType 时使用的联合组件。

SetAgentMeasurementPeriod.hAgent

代理的唯一标识符。 代理处理程序负责生成和维护此标识符的唯一性。

SetAgentMeasurementPeriod.dwMeasurementPeriod

开关或实现存储和计算信息的时间段（以秒为单位）。 例如， dwNumberOfACDCalls 保存代理处理的调用数; dwMeasurementPeriod 指示此值是否引用了过去一小时、一天或一个月内处理的调用。

GetAgentInfo

LINEPROXYREQUEST_GETAGENTINFO dwRequestType 时使用的联合组件。

GetAgentInfo.hAgent

代理的唯一标识符。 代理处理程序负责生成和维护此标识符的唯一性。

GetAgentInfo.AgentInfo

LINEAGENTINFO 类型的结构。

CreateAgentSession

LINEPROXYREQUEST_CREATEAGENTSESSION dwRequestType 时使用的联合组件。

CreateAgentSession.hAgentSession

代理会话的唯一标识符。

CreateAgentSession.dwAgentPINSize

代理 PIN 字符串的大小（包括 null 终止符），以字节为单位。

CreateAgentSession.dwAgentPINOffset

从 结构的开头偏移到以 null 结尾的字符串，该字符串指定代理的 PIN 或密码。 此字符串的大小由 dwAgentPINSize 指定。

CreateAgentSession.hAgent

代理的唯一标识符。 代理处理程序负责生成和维护此标识符的唯一性。

CreateAgentSession.GroupID

ACD 组的通用唯一标识符。 代理处理程序负责生成和维护此标识符的唯一性。

CreateAgentSession.dwWorkingAddressID

代理将接收此会话的呼叫的地址的标识符。

GetAgentSessionList

LINEPROXYREQUEST_GETAGENTSESSIONLIST dwRequestType 时使用的联合组件。

GetAgentSessionList.hAgent

代理的唯一标识符。 代理处理程序负责生成和维护此标识符的唯一性。

GetAgentSessionList.SessionList

LINEAGENTSESSIONLIST 类型的结构。

GetAgentSessionInfo

LINEPROXYREQUEST_GETAGENTSESSIONINFO dwRequestType 时使用的联合组件。

GetAgentSessionInfo.hAgentSession

代理会话的唯一标识符。 代理处理程序负责生成和维护此标识符的唯一性。

GetAgentSessionInfo.SessionInfo

LINEAGENTSESSIONINFO 类型的结构。

SetAgentSessionState

LINEPROXYREQUEST_SETAGENTSESSIONSTATE dwRequestType 时使用的联合组件。

SetAgentSessionState.hAgentSession

代理会话的唯一标识符。 代理处理程序负责生成和维护此标识符的唯一性。

SetAgentSessionState.dwAgentSessionState

LINEAGENTSESSIONSTATE_常量之一。

SetAgentSessionState.dwNextAgentSessionState

LINEAGENTSESSIONSTATE_常量之一。

GetQueueList

LINEPROXYREQUEST_GETQUEUELIST dwRequestType 时使用的联合组件。

GetQueueList.GroupID

ACD 组的通用唯一标识符。 代理处理程序负责生成和维护此标识符的唯一性。

GetQueueList.QueueList

LINEQUEUELIST 类型的结构。

SetQueueMeasurementPeriod

LINEPROXYREQUEST_SETQUEUEMEASUREMENTPERIOD dwRequestType 时使用的联合组件。

SetQueueMeasurementPeriod.dwQueueID

队列的唯一标识符。 代理处理程序负责生成和维护此标识符的唯一性。

SetQueueMeasurementPeriod.dwMeasurementPeriod

开关或实现存储和计算信息的时间段（以秒为单位）。

GetQueueInfo

LINEPROXYREQUEST_GETQUEUEINFO dwRequestType 时使用的联合组件。

GetQueueInfo.dwQueueID

队列的唯一标识符。 代理处理程序负责生成和维护此标识符的唯一性。

GetQueueInfo.QueueInfo

LINEQUEUEINFO 类型的结构。

GetGroupList

LINEPROXYREQUEST_GETGROUPLIST dwRequestType 时使用的联合组件。

GetGroupList.GroupList

LINEAGENTGROUPLIST 类型的结构。

注解

地址标识符与地址永久关联;标识符在操作系统升级中保持不变。

要求

要求 值
Header tapi.h

另请参阅

LINEAGENTACTIVITYLIST

LINEAGENTCAPS

LINEAGENTGROUPLIST

LINEAGENTSESSIONINFO

LINEAGENTSESSIONLIST

LINEAGENTSTATUS

LINEQUEUELIST

LINE_PROXYREQUEST

lineProxyResponse