📄 struc1_794i.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>LINEAGENTCAPS</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="LINEAGENTCAPS">
<META NAME="MS-HAID" CONTENT="_tapi2_lineagentcaps_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_lineagentcaps_str"></A>LINEAGENTCAPS</H1>
<P>The <B>LINEAGENTCAPS</B> structure describes the capabilities of an ACD agent. The <A HREF="func1_7ptf.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7ptf.htm"><B>lineGetAgentCaps</B></A> function returns the <B>LINEAGENTCAPS</B> structure.</P>
<PRE class=syntax>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; //TAPI Version 2.2
} LINEAGENTCAPS, *LPLINEAGENTCAPS;</PRE>
<H4>Members</H4>
<DL>
<DT><B>dwTotalSize</B></DT>
<DD>The total size, in bytes, allocated to this data structure.</DD>
<DT><B>dwNeededSize</B></DT>
<DD>The size, in bytes, needed to hold all the information requested.</DD>
<DT><B>dwUsedSize</B></DT>
<DD>The size, in bytes, of the portion of this data structure that contains useful information.</DD>
<DT><B>dwAgentHandlerInfoSize</B> </DT>
<DT><B>dwAgentHandlerInfoOffset</B> </DT>
<DD>The size, in bytes, and offset from the beginning of <B>LINEAGENTCAPS</B> of a null-terminated string specifying the name, version, or other identifying information of the server application that is handling agent requests. </DD>
<DT><B>dwCapsVersion</B> </DT>
<DD>The TAPI version that the agent handler application used in preparing the contents of this structure. This is no greater than the API version that the calling application passed in to <A HREF="func1_7ptf.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7ptf.htm"><B>lineGetAgentCaps</B></A>. </DD>
<DT><B>dwFeatures</B> </DT>
<DD>The agent-related features available for this line using the <A HREF="constnts_2tmb.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_2tmb.htm">LINEAGENTFEATURE_ constants</A>. Invoking a supported feature requires the line and address to be in the proper state. A zero in a bit position indicates that the corresponding feature is never available. A one indicates that the corresponding feature may be available if the line is in the appropriate state for the operation to be meaningful. This field allows an application to discover which agent features can be (and which can never be) supported by the device. </DD>
<DT><B>dwStates</B> </DT>
<DD>The <A HREF="constnts_9shf.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_9shf.htm">LINEAGENTSTATE_ constants</A> that can be used in the <I>dwAgentState</I> parameter of <A HREF="func1_7lk5.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7lk5.htm"><B>lineSetAgentState</B></A>. Setting a supported state requires the line and address to be in the proper state. A zero in a bit position indicates that the corresponding state is never available. A one indicates that the corresponding state may be available if the line is in the appropriate state for the state to be meaningful. This field allows an application to discover which agent states can be (and which can never be) supported on the device. </DD>
<DT><B>dwNextStates</B> </DT>
<DD>The LINEAGENTSTATE_ constants that can be used in the <I>dwNextAgentState</I> parameter of <B>lineSetAgentState</B>. Setting a supported state requires the line and address to be in the proper state. A zero in a bit position indicates that the corresponding state is never available. A one indicates that the corresponding state may be available if the line is in the appropriate state for the state to be meaningful. This field allows an application to discover which agent states can be (and which can never be) supported on the device. </DD>
<DT><B>dwMaxNumGroupEntries</B> </DT>
<DD>The maximum number of agent identifiers that can be logged in on the address simultaneously. Determines the highest value that can be passed in as the <B>dwNumEntries</B> member in the <A HREF="struc1_5z02.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_5z02.htm"><B>LINEAGENTGROUPLIST</B></A> structure to <A HREF="func1_2gq8.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_2gq8.htm"><B>lineSetAgentGroup</B></A>. </DD>
<DT><B>dwAgentStatusMessages</B> </DT>
<DD>Indicates the <A HREF="constnts_0yyb.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_0yyb.htm">LINEAGENTSTATUS_ constants</A> that can be received by the application in <I>dwParam2</I> of a <A HREF="msgs_0mr7.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_0mr7.htm">LINE_AGENTSTATUS</A> message. </DD>
<DT><B>dwNumAgentExtensionIDs</B> </DT>
<DD>The number of <A HREF="struc2_1t6a.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_1t6a.htm"><B>LINEEXTENSIONID</B></A> structures that appear in the <I>ExtensionIDList</I> array. The value is 0 if agent-handler-specific extensions are supported on the address. </DD>
<DT><B>dwAgentExtensionIDListSize</B> </DT>
<DT><B>dwAgentExtensionIDListOffset</B> </DT>
<DD>Total size, in bytes, and offset from the beginning of <B>LINEAGENTCAPS</B> of an array of <B>LINEEXTENSIONID</B> elements. The size is <B>dwNumExtensionIDs</B> times SIZEOF(LINEEXTENSIONID). The array lists the 128-bit universally unique identifiers for all agent-handler-specific extensions supported by the agent handle for the address. The extension being used is referenced in the <A HREF="func1_0s6b.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_0s6b.htm"><B>lineAgentSpecific</B></A> function and <A HREF="msgs_6337.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_6337.htm">LINE_AGENTSPECIFIC</A> message by its position in this table, the first entry being entry 0, so it is important that the agent handler always present extension identifiers in this array in the same order. </DD>
<DT><B>ProxyGUID</B></DT>
<DD>GUID for ACD proxy associated with the line. This element is exposed only to applications that negotiate a TAPI version of 2.2 or higher.
</DD>
</DL>
<H4><A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/sdkintro/guide_927n.htm \n\n这个文件不能通过 Teleport Pro 取回, 因为 地址在一个域或为它的开始地址设定的边界的外部路径上. \n\n你想从服务器打开它吗?'))window.location='http://msdn.microsoft.com/library/psdk/sdkintro/guide_927n.htm'" tppabs="http://msdn.microsoft.com/library/psdk/sdkintro/guide_927n.htm">Requirements</A> </H4>
<P><B> Windows NT/2000: </B>Requires Windows NT 4.0 SP3 or later.<BR>
<B> Windows 95/98: </B>Requires Windows 95 or later.<BR>
<B> Version: </B>Requires TAPI 2.0 or later.<BR>
<B> Header: </B>Declared in Tapi.h.</P>
<H4>See Also</H4>
<P><A HREF="msgs_6337.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_6337.htm">LINE_AGENTSPECIFIC</A>, <A HREF="msgs_0mr7.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_0mr7.htm">LINE_AGENTSTATUS</A>, <A HREF="struc1_5z02.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_5z02.htm"><B>LINEAGENTGROUPLIST</B></A>, <A HREF="func1_0s6b.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_0s6b.htm"><B>lineAgentSpecific</B></A>, <A HREF="struc2_1t6a.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_1t6a.htm"><B>LINEEXTENSIONID</B></A>, <A HREF="func1_7ptf.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7ptf.htm"><B>lineGetAgentCaps</B></A>, <A HREF="struc1_83ci.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_83ci.htm"><B>LINEPROXYREQUEST</B></A>, <A HREF="func1_2gq8.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_2gq8.htm"><B>lineSetAgentGroup</B></A>, <A HREF="func1_7lk5.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7lk5.htm"><B>lineSetAgentState</B></A> </P>
<DIV CLASS="footer">Built on Monday, August 14, 2000</DIV>
<!--FOOTER_START-->
<DIV CLASS="footer" STYLE="color:#000000;font-size:90%;">
<A HREF="mailto:sdkfdbk@microsoft.com">Send feedback</A> to the Platform SDK.</P>
<P><A HREF="javascript:if(confirm('http://msdn.microsoft.com/isapi/gomscom.asp?TARGET=/info/cpyright.htm \n\n这个文件不能通过 Teleport Pro 取回, 因为 地址在一个域或为它的开始地址设定的边界的外部路径上. \n\n你想从服务器打开它吗?'))window.location='http://msdn.microsoft.com/isapi/gomscom.asp?TARGET=/info/cpyright.htm'" tppabs="http://msdn.microsoft.com/isapi/gomscom.asp?TARGET=/info/cpyright.htm" TARGET="_top">© 1999 Microsoft Corporation. All rights reserved. Terms of use.</A></P>
</DIV>
<!--FOOTER_END-->
</BODY>
</HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -