?? func1_9b1u.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>lineCompleteTransfer</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineCompleteTransfer">
<META NAME="MS-HAID" CONTENT="_tapi2_linecompletetransfer">
</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_linecompletetransfer"></A>lineCompleteTransfer</H1>
<P>The <B>lineCompleteTransfer</B> function completes the transfer of the specified call to the party connected in the consultation call. </P>
<PRE class=syntax><B>LONG WINAPI lineCompleteTransfer(
HCALL</B><I> hCall</I><B>, </B>
<B> HCALL</B><I> hConsultCall</I><B>, </B>
<B> LPHCALL</B><I> lphConfCall</I><B>, </B>
<B> DWORD</B><I> dwTransferMode </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hCall</I> </DT>
<DD>A handle to the call to be transferred. The application must be an owner of this call. The call state of <I>hCall</I> must be <I>onHold, onHoldPendingTransfer</I>. </DD>
<DT><I>hConsultCall</I> </DT>
<DD>A handle to the call that represents a connection with the destination of the transfer. The application must be an owner of this call. The call state of <I>hConsultCall</I> must be <I>connected</I>, <I>ringback</I>, <I>busy</I>, or <I>proceeding</I>. </DD>
<DT><I>lphConfCall</I> </DT>
<DD>A pointer to a memory location where an <I>hCall</I> handle can be returned. If <I>dwTransferMode</I> is LINETRANSFERMODE_CONFERENCE, the newly created conference call is returned in <I>lphConfCall</I> and the application becomes the sole owner of the conference call. Otherwise, this parameter is ignored by TAPI. </DD>
<DT><I>dwTransferMode</I> </DT>
<DD>Specifies how the initiated transfer request is to be resolved. This parameter uses one of the <A HREF="constnts_7x0z.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_7x0z.htm">LINETRANSFERMODE_ Constants</A>. </DD>
</DL>
<H4>Return Values</H4>
<P>Returns a positive request identifier if the function is completed asynchronously, or a negative error number if an error occurs. The <I>dwParam2</I> parameter of the corresponding <A HREF="msgs_65mh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_65mh.htm">LINE_REPLY</A> message is zero if the function succeeds or it is a negative error number if an error occurs. Possible return values are: </P>
<P>LINEERR_INVALCALLHANDLE, LINEERR_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCONSULTCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALTRANSFERMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM. </P>
<H4>Remarks</H4>
<P>The LINE_REPLY message sent in response to a call to the <B>lineCompleteTransfer</B> function is based on the status of the call specified by the <I>hCall</I> parameter. </P>
<P>This operation completes the transfer of the original call, <I>hCall</I>, to the party currently connected by <I>hConsultCall</I>. The consultation call is typically dialed on the consultation call allocated as part of <A HREF="func2_8ofm.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_8ofm.htm"><B>lineSetupTransfer</B></A>, but it can be any call to which the switch is capable of transferring <I>hCall</I>. </P>
<P>The transfer request can be resolved either as a transfer or as a three-way conference call. When resolved as a transfer, the parties connected by <I>hCall</I> and <I>hConsultCall</I> are connected to each other, and both <I>hCall</I> and <I>hConsultCall</I> are typically cleared from the application's line and transition to the <I>idle</I> state. The application's call handle remains valid after the transfer has completed. The application must deallocate its handle with <A HREF="func1_3wto.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_3wto.htm"><B>lineDeallocateCall</B></A> when it is no longer interested in the transferred call. </P>
<P>When resolved as a conference, all three parties enter into a conference call. Both existing call handles remain valid but transition to the <I>conferenced</I> state. A conference call handle is created and returned, and it transitions to the <I>connected</I> state. </P>
<P>If <A HREF="func1_5qlv.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_5qlv.htm"><B>lineGetConfRelatedCalls</B></A> is called immediately after <B>lineCompleteTransfer</B> with the result that the calls are conferenced, <B>lineGetConfRelatedCalls</B> may not return a complete list of related calls. This is because TAPI waits to receive a <A HREF="msgs_1xid.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_1xid.htm">LINE_CALLSTATE</A> message indicating that the call has entered LINECALLSTATE_CONFERENCED before it considers the call to actually be part of the conference. That is, it waits for the service provider to confirm the conferenced state. After the application has received the LINE_CALLSTATE message, <B>lineGetConfRelatedCalls</B> returns complete information. </P>
<P>It can also be possible to perform a blind transfer of a call using <B>lineBlindTransfer</B>. </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 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_1isy.htm \n\n這個文件不能通過 Teleport Pro 取回, 因為 地址在一個域或為它的開始地址設定的邊界的外部路徑上. \n\n你想從服務器打開它嗎?'))window.location='http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_1isy.htm'" tppabs="http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_1isy.htm">Transfer 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_6gvn.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/quickref_6gvn.htm">Supplementary Line Service Functions</A>, <A HREF="msgs_1xid.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_1xid.htm">LINE_CALLSTATE</A>, <A HREF="msgs_65mh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_65mh.htm">LINE_REPLY</A>, <A HREF="func1_36wi.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_36wi.htm"><B>lineBlindTransfer</B></A>, <A HREF="func1_3wto.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_3wto.htm"><B>lineDeallocateCall</B></A>, <A HREF="func1_5qlv.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_5qlv.htm"><B>lineGetConfRelatedCalls</B></A>, <A HREF="func2_8ofm.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_8ofm.htm"><B>lineSetupTransfer</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 + -