?? struc1_83ci.htm
字號:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML DIR="LTR"><HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=iso8859-1">
</HEAD>
<TITLE>LINEPROXYREQUEST</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="LINEPROXYREQUEST">
<META NAME="MS-HAID" CONTENT="_tapi2_lineproxyrequest_str">
</HEAD>
<BODY TOPMARGIN="0">
<!--TOOLBAR_START-->
<!--TOOLBAR_EXEMPT-->
<!--TOOLBAR_END-->
<!--SYNC_START-->
<script language="JavaScript" src='/library/synch.js'></script>
<!--SYNC_END-->
<H1><A NAME="_tapi2_lineproxyrequest_str"></A>LINEPROXYREQUEST</H1>
<P>The <B>LINEPROXYREQUEST</B> structure contains parameter values of the application making the proxy request. Multiple <A HREF="func1_8kmr.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_8kmr.htm">TAPI call center functions</A> generate a <A HREF="msgs_3cfo.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_3cfo.htm"><B>LINE_PROXYREQUEST</B></A> message that references a <B>LINEPROXYREQUEST</B> structure.</P>
<PRE class=syntax>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; // TAPI v3.0
DWORD dwAgentIDSize; // TAPI v3.0
DWORD dwAgentIDOffset; // TAPI v3.0
DWORD dwAgentPINSize; // TAPI v3.0
DWORD dwAgentPINOffset;
} CreateAgent;
struct {
HAGENT hAgent; // TAPI v3.0
DWORD dwAgentState; // TAPI v3.0
DWORD dwNextAgentState; // TAPI v3.0
} SetAgentStateEx;
struct {
HAGENT hAgent; // TAPI v3.0
DWORD dwMeasurementPeriod; // TAPI v3.0
} SetAgentMeasurementPeriod;
struct {
HAGENT hAgent; // TAPI v3.0
LINEAGENTINFO AgentInfo; // TAPI v3.0
} GetAgentInfo;
struct {
HAGENTSESSION hAgentSession; // TAPI v3.0
DWORD dwAgentPINSize;
DWORD dwAgentPINOffset;
HAGENT hAgent; // TAPI v3.0
GUID GroupID; // TAPI v3.0
DWORD dwWorkingAddressID; // TAPI v3.0
} CreateAgentSession;
struct {
HAGENT hAgent; // TAPI v3.0
LINEAGENTSESSIONLIST SessionList; // TAPI v3.0
} GetAgentSessionList;
struct {
HAGENTSESSION hAgentSession; // TAPI v3.0
LINEAGENTSESSIONINFO SessionInfo; // TAPI v3.0
} GetAgentSessionInfo;
struct {
HAGENTSESSION hAgentSession; // TAPI v3.0
DWORD dwAgentSessionState; // TAPI v3.0
DWORD dwNextAgentSessionState; // TAPI v3.0
} SetAgentSessionState;
struct {
GUID GroupID; // TAPI v3.0
LINEQUEUELIST QueueList; // TAPI v3.0
} GetQueueList;
struct {
DWORD dwQueueID; // TAPI v3.0
DWORD dwMeasurementPeriod; // TAPI v3.0
} SetQueueMeasurementPeriod;
struct {
DWORD dwQueueID; // TAPI v3.0
LINEQUEUEINFO QueueInfo; // TAPI v3.0
} GetQueueInfo;
struct {
LINEAGENTGROUPLIST GroupList; // TAPI v3.0
} GetGroupList;
};
} LINEPROXYREQUEST, *LPLINEPROXYREQUEST;</PRE>
<H4>Members</H4>
<DL>
<DT><B>dwSize</B> </DT>
<DD>The total number of bytes allocated by TAPI to contain the <B>LINEPROXYREQUEST</B> structure. The <B>dwTotalSize</B> member of any structure contained within <B>LINEPROXYREQUEST</B> (for example, <A HREF="struc1_794i.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_794i.htm"><B>LINEAGENTCAPS</B></A>) reflects only the number of bytes allocated for that specific structure. </DD>
<DT><B>dwClientMachineNameSize</B> </DT>
<DT><B>dwClientMachineNameOffset</B> </DT>
<DD>Size, in bytes, (including the terminating NULL) and offset from the beginning of <B>LINEPROXYREQUEST</B> of a null-terminated string identifying the client machine that made this request. </DD>
<DT><B>dwClientUserNameSize</B> </DT>
<DT><B>dwClientUserNameOffset</B> </DT>
<DD>Size, in bytes, (including the terminating NULL) and offset from the beginning of <B>LINEPROXYREQUEST</B> of a null-terminated string identifying the user under whose account the application is running on the client machine. </DD>
<DT><B>dwClientAppAPIVersion</B> </DT>
<DD>The global (highest) API version supported by the application that made the request. The proxy handler should restrict the contents of any data returned to the application to those members and values that were defined in this, or earlier, versions of TAPI. </DD>
<DT><B>dwRequestType</B> </DT>
<DD>One of the <A HREF="constnts_0vsj.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_0vsj.htm">LINEPROXYREQUEST_ Constants</A>. Identifies the type of function and the union component that defines the remaining data in the structure. </DD>
<DT><B>SetAgentGroup</B> </DT>
<DD>The union component used when <B>dwRequestType</B> is LINEPROXYREQUEST_SETAGENT.
<DL>
<DT><B>dwAddressID</B> </DT>
<DD>The identifier of the address for which the agent is to be set. </DD>
<DT><B>GroupList</B> </DT>
<DD>A structure of type <A HREF="struc1_5z02.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_5z02.htm"><B>LINEAGENTGROUPLIST</B></A>. Offsets within this structure are relative to the beginning of <B>SetAgentGroup.GroupList</B> rather than to the beginning of the <B>LINEPROXYREQUEST</B> structure. </DD>
</DL>
</DD>
<DT><B>SetAgentState</B> </DT>
<DD>The union component used when <B>dwRequestType</B> is LINEPROXYREQUEST_SETAGENTSTATE.
<DL>
<DT><B>dwAddressID</B> </DT>
<DD>The identifier of the address for which the agent state is to be set. </DD>
<DT><B>dwAgentState</B> </DT>
<DD>The new agent state, or zero to leave the agent state unchanged. </DD>
<DT><B>dwNextAgentState</B> </DT>
<DD>The new next agent state, or zero to use the default next state associated with the specified agent state. </DD>
</DL>
</DD>
<DT><B>SetAgentActivity</B> </DT>
<DD>The union component used when <B>dwRequestType</B> is LINEPROXYREQUEST_SETAGENTACTIVITY.
<DL>
<DT><B>dwAddressID</B> </DT>
<DD>The identifier of the address for which the agent activity is to be set. </DD>
<DT><B>dwActivityID</B> </DT>
<DD>The identifier for the activity being selected. </DD>
</DL>
</DD>
<DT><B>GetAgentCaps</B> </DT>
<DD>The union component used when <B>dwRequestType</B> is LINEPROXYREQUEST_GETAGENTCAPS.
<DL>
<DT><B>dwAddressID</B> </DT>
<DD>The identifier of the address for which the agent capabilities are to be retrieved. </DD>
<DT><B>AgentCaps</B> </DT>
<DD>A structure of type <A HREF="struc1_794i.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_794i.htm"><B>LINEAGENTCAPS</B></A>. Offsets within this structure are relative to the beginning of <B>GetAgentCaps.AgentCaps</B> rather than to the beginning of the <B>LINEPROXYREQUEST</B> structure. The <B>dwTotalSize</B> member is set by TAPI and the remaining bytes set to zero. The proxy handler must fill in <B>dwNeededSize</B>, <B>dwUsedSize</B>, and the remaining members as appropriate, before calling <A HREF="func1_4lyd.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_4lyd.htm"><B>lineProxyResponse</B></A>. </DD>
</DL>
</DD>
<DT><B>GetAgentStatus</B> </DT>
<DD>The union component used when <B>dwRequestType</B> is LINEPROXYREQUEST_SETAGENTGROUP.
<DL>
<DT><B>dwAddressID</B> </DT>
<DD>The identifier of the address for which the agent status is to be retrieved. </DD>
<DT><B>AgentStatus</B> </DT>
<DD>A structure of type <A HREF="struc1_7wqa.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_7wqa.htm"><B>LINEAGENTSTATUS</B></A>. Offsets within this structure are relative to the beginning of <B>GetAgentStatus.AgentStatus</B> rather than to the beginning of the <B>LINEPROXYREQUEST</B> structure. The <B>dwTotalSize</B> member is set by TAPI and the remaining bytes set to zero. The proxy handler must fill in <B>dwNeededSize</B>, <B>dwUsedSize</B>, and the remaining members as appropriate, before calling <A HREF="func1_4lyd.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_4lyd.htm"><B>lineProxyResponse</B></A>. </DD>
</DL>
</DD>
<DT><B>AgentSpecific</B> </DT>
<DD>The union component used when <B>dwRequestType</B> is LINEPROXYREQUEST_AGENTSPECIFIC.
<DL>
<DT><B>dwAddressID</B> </DT>
<DD>The identifier of the address for which the agent status is to be retrieved. </DD>
<DT><B>dwAgentExtensionIDIndex</B> </DT>
<DD>The index of the handler extension being invoked; the identifier's position within the array of extension identifiers returned in <A HREF="struc1_794i.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_794i.htm"><B>LINEAGENTCAPS</B></A>. </DD>
<DT><B>dwSize</B> </DT>
<DD>The total size, in bytes, of the <B>Params</B> parameter block. </DD>
<DT><B>Params</B> </DT>
<DD>A block of memory that includes the contents passed to the handler from the application. If the handler is to return data to the application, it must be written into this parameter block before calling <A HREF="func1_4lyd.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_4lyd.htm"><B>lineProxyResponse</B></A>. </DD>
</DL>
</DD>
<DT><B>GetAgentActivityList</B> </DT>
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -