?? func1_3wto.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>lineDeallocateCall</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineDeallocateCall">
<META NAME="MS-HAID" CONTENT="_tapi2_linedeallocatecall">
</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_linedeallocatecall"></A>lineDeallocateCall</H1>
<P>The <B>lineDeallocateCall</B> function deallocates the specified call handle. </P>
<PRE class=syntax><B>LONG WINAPI lineDeallocateCall(
HCALL</B><I> hCall </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hCall</I> </DT>
<DD>The call handle to be deallocated. An application with monitoring privileges for a call can always deallocate its handle for that call. An application with owner privilege for a call can deallocate its handle unless it is the sole owner of the call and the call is not in the <I>idle</I> state. The call handle is no longer valid after it has been deallocated.
</DD>
</DL>
<H4>Return Values</H4>
<P>Returns zero if the request succeeds or a negative error number if an error occurs. Possible return values are: </P>
<P>LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.</P>
<H4>Remarks</H4>
<P>The deallocation does not affect the call state of the physical call. It does, however, release internal resources related to the call. </P>
<P>In API versions earlier than 2.0, if the application is the sole owner of a call and the call is not in the <I>idle</I> state, LINEERR_INVALCALLSTATE is returned. In this case, the application can first drop the call using <A HREF="func1_1i5s.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_1i5s.htm"><B>lineDrop</B></A> and deallocate its call handle afterwards. An application that has monitor privilege for a call can always deallocate its handle for the call. </P>
<P>In API versions 2.0 or later, the sole owner of the call <I>can</I> deallocate its handle even though the call is not in the <I>idle</I> state. (This allows for distributed control of the call in a client/server environment.) </P>
<P class=note><B>Note</B> Be aware that leaving the call without an owner can result in the user being unable to terminate the call if there are monitoring applications open preventing TAPI from calling <A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/tspi21/func1_4964.htm \n\n這個文件不能通過 Teleport Pro 取回, 因為 地址在一個域或為它的開始地址設(shè)定的邊界的外部路徑上. \n\n你想從服務(wù)器打開它嗎?'))window.location='http://msdn.microsoft.com/library/psdk/tspi21/func1_4964.htm'" tppabs="http://msdn.microsoft.com/library/psdk/tspi21/func1_4964.htm"><B>TSPI_lineCloseCall</B></A>. Use this feature only if the application can determine that the call can be controlled externally by the user (see LINEADDRCAPFLAGS_CLOSEDROP). </P>
<P>In API versions earlier than 2.0, when the <B>lineDeallocateCall</B> function deallocates a call handle, it also suspends further processing of any outstanding LINE_REPLY messages for the call. An application must be designed <I>not</I> to wait indefinitely for LINE_REPLY messages for each corresponding call to an asynchronous function if it also uses the <B>lineDeallocateCall</B> function to deallocate handles. </P>
<P>In API versions 2.0 or later, <B>lineDeallocateCall</B> does not suspend outstanding LINE_REPLY messages; every asynchronous function that returns a <I>dwRequestID</I> to the application always results in the delivery of the associated LINE_REPLY message unless the application calls <A HREF="func2_7sq6.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_7sq6.htm"><B>lineShutdown</B></A>. </P>
<H4><A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/sdkintro/guide_927n.htm \n\n這個文件不能通過 Teleport Pro 取回, 因為 地址在一個域或為它的開始地址設(shè)定的邊界的外部路徑上. \n\n你想從服務(wù)器打開它嗎?'))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 1.3 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="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_6sxe.htm \n\n這個文件不能通過 Teleport Pro 取回, 因為 地址在一個域或為它的開始地址設(shè)定的邊界的外部路徑上. \n\n你想從服務(wù)器打開它嗎?'))window.location='http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_6sxe.htm'" tppabs="http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_6sxe.htm">Terminate a Session Overview</A>, <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_1pnp.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/quickref_1pnp.htm">Basic Telephony Services Reference</A>, <A HREF="msgs_65mh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_65mh.htm">LINE_REPLY</A>, <A HREF="func1_1i5s.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_1i5s.htm"><B>lineDrop</B></A>, <A HREF="func2_7sq6.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_7sq6.htm"><B>lineShutdown</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 取回, 因為 地址在一個域或為它的開始地址設(shè)定的邊界的外部路徑上. \n\n你想從服務(wù)器打開它嗎?'))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>
?? 快捷鍵說明
復(fù)制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -