📄 func1_0s6b.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>lineAgentSpecific</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineAgentSpecific">
<META NAME="MS-HAID" CONTENT="_tapi2_lineagentspecific">
</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_lineagentspecific"></A>lineAgentSpecific</H1>
<P>The <B>lineAgentSpecific</B> function allows the application to access proprietary handler-specific functions of the agent handler associated with the address. The meaning of the extensions are specific to the agent handler. Each set of agent-related extensions is identified by a universally unique 128-bit extension ID that must be obtained, along with the specification for the extension, from the promulgator of that extension (usually the author of the agent handler software on the telephony server). The list of extensions supported by the agent handler is obtained from the <A HREF="struc1_794i.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_794i.htm"><B>LINEAGENTCAPS</B></A> structure returned by <A HREF="func1_7ptf.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7ptf.htm"><B>lineGetAgentCaps</B></A>. </P>
<PRE class=syntax><B>LONG WINAPI lineAgentSpecific(
HLINE</B><I> hLine</I><B>, </B>
<B> DWORD</B><I> dwAddressID</I><B>, </B>
<B> DWORD</B><I> dwAgentExtensionIDIndex</I><B>, </B>
<B> LPVOID</B><I> lpParams</I><B>, </B>
<B> DWORD</B><I> dwSize </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hLine</I> </DT>
<DD>A handle to the open line device. </DD>
<DT><I>dwAddressID</I> </DT>
<DD>An address on the open line device. An address identifier is permanently associated with an address; the identifier remains constant across operating system upgrades.</DD>
<DT><I>dwAgentExtensionIDIndex</I> </DT>
<DD>The position in the <I>ExtensionIDList</I> structure in <A HREF="struc1_794i.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_794i.htm"><B>LINEAGENTCAPS</B></A> of the agent handler extension being invoked. </DD>
<DT><I>lpParams</I> </DT>
<DD>A pointer to a memory area used to hold a parameter block. The format of this parameter block is device specific and its contents are passed by TAPI to and from the agent handler application on the telephony server. This parameter block must specify the function to be invoked and include sufficient room for any data to be returned. </DD>
<DT><I>dwSize</I> </DT>
<DD>The size, in bytes, of the parameter block area.
</DD>
</DL>
<H4>Return Values</H4>
<P>Returns a positive request identifier if the asynchronous operation starts; otherwise, this function returns one of these negative error values: </P>
<P>LINEERR_INVALADDRESSID, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED. </P>
<P>Additional return values are specific to the agent handler. </P>
<H4>Remarks</H4>
<P>This operation is part of the Extended Telephony services. It provides access to an agent handler-specific feature without defining its meaning. </P>
<P>This function provides a generic parameter profile. The interpretation of the parameter structure is handler specific. Indications and replies sent back to the application that are handler specific should use the <A HREF="msgs_6337.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_6337.htm">LINE_AGENTSPECIFIC</A> message. </P>
<P>An agent handler can provide access to handler-specific functions by defining parameters for use with this function. Applications that want to make use of these extensions should consult the vendor-specific documentation that describes what extensions are defined. Typically, an application that relies on these extensions is not able to work with other agent handler environments. </P>
<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.<BR>
<B> Library: </B>Use Tapi32.lib.</P>
<H4>See Also</H4>
<P><A HREF="quickref_1okl.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/quickref_1okl.htm">TAPI 2.2 Reference Overview</A>, <A HREF="quickref_6gvn.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/quickref_6gvn.htm">Supplementary Line Service Functions</A>, <A HREF="struc1_794i.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_794i.htm"><B>LINEAGENTCAPS</B></A>, <A HREF="func1_7ptf.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7ptf.htm"><B>lineGetAgentCaps</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 + -