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