?? 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 + -