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
SetAgentStateEx.dwNextAgentState
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
SetAgentSessionState.dwNextAgentSessionState
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 |