?? func2_8ofm.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>lineSetupTransfer</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineSetupTransfer">
<META NAME="MS-HAID" CONTENT="_tapi2_linesetuptransfer">
</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_linesetuptransfer"></A>lineSetupTransfer</H1>
<P>The <B>lineSetupTransfer</B> function initiates a transfer of the call specified by the <I>hCall </I>parameter. It establishes a consultation call, <I>lphConsultCall</I>, on which the party can be dialed that can become the destination of the transfer. The application acquires owner privilege to the <I>lphConsultCall </I>parameter. </P>
<PRE class=syntax><B>LONG WINAPI lineSetupTransfer(
HCALL</B><I> hCall</I><B>, </B>
<B> LPHCALL</B><I> lphConsultCall</I><B>, </B>
<B> LPLINECALLPARAMS const</B><I> lpCallParams </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hCall</I> </DT>
<DD>The handle of the call to be transferred. The application must be an owner of the call. The call state of <I>hCall</I> must be <I>connected</I>. </DD>
<DT><I>lphConsultCall</I> </DT>
<DD>A pointer to an <I>hCall</I> handle. This location is then loaded with a handle identifying the temporary consultation call. When setting up a call for transfer, a consultation call is automatically allocated that enables <A HREF="func1_0p0s.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_0p0s.htm"><B>lineDial</B></A> to dial the address associated with the new transfer destination of the call. The originating party can carry on a conversation over this consultation call prior to completing the transfer. The call state of <I>hConsultCall</I> is not applicable.
<P>This transfer procedure may not be valid for some line devices. The application may need to ignore the new consultation call and unhold an existing held call (using <A HREF="func2_2ulg.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_2ulg.htm"><B>lineUnhold</B></A>) to identify the destination of the transfer. On switches that support cross-address call transfer, the consultation call can exist on a different address than the call to be transferred. It may also be necessary that the consultation call be set up as an entirely new call, by <A HREF="func1_7mgc.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7mgc.htm"><B>lineMakeCall</B></A>, to the destination of the transfer. Which forms of transfer are available are specified in the call's address capabilities.
</DD>
<DT><I>lpCallParams</I> </DT>
<DD>A pointer to call parameters to be used when establishing the consultation call. This parameter is one or more of the <A HREF="constnts_9ilv.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_9ilv.htm">LINECALLPARAMFLAGS_ constants</A>. This parameter can be set to NULL if no special call setup parameters are desired.</DD>
</DL>
<P></P>
<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_BEARERMODEUNAVAIL, LINEERR_INVALRATE, LINEERR_CALLUNAVAIL, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_NOTOWNER, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLPARAMS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_INVALMEDIAMODE, LINEERR_USERUSERINFOTOOBIG, LINEERR_INVALPOINTER. </P>
<H4>Remarks</H4>
<P>The <B>lineSetupTransfer</B> function sets up the transfer of the call specified by <I>hCall</I>. The setup phase of a transfer establishes a consultation call that enables the application to send the address of the destination (the party to be transferred to) to the switch, while the call to be transferred is kept on hold. This new call is referred to as a consultation call (<I>hConsultCall</I>) and can be dropped or otherwise manipulated independently of the original call. </P>
<P>When the consultation call has reached the <I>dialtone</I> call state, the application can proceed transferring the call either by dialing the destination address and tracking its progress, or by unholding an existing call. The transfer of the original call to the selected destination is completed using <A HREF="func1_9b1u.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_9b1u.htm"><B>lineCompleteTransfer</B></A>. </P>
<P>While the consultation call exists, the original call typically transitions to the <I>onholdPendingTransfer</I> state. The application may be able to toggle between the consultation call and the original call by using <A HREF="func2_4rxg.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_4rxg.htm"><B>lineSwapHold</B></A>. A consultation call can be canceled by invoking <A HREF="func1_1i5s.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_1i5s.htm"><B>lineDrop</B></A> on it. After dropping a consultation call, the original call typically transitions back to the <I>connected</I> state. If the call state of the original call is <I>onHoldPendingTransfer</I>, the <A HREF="func2_2ulg.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_2ulg.htm"><B>lineUnhold</B></A> function can be used to recover the call. In this case, the call state of the consultation call is set to <I>idle</I>. </P>
<P>The application can also transfer calls in a single step, without having to deal with the intervening consultation call, by using <A HREF="func1_36wi.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_36wi.htm"><B>lineBlindTransfer</B></A>. </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.<BR>
<B> Unicode: </B>Implemented as Unicode and ANSI versions on all platforms.</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_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_9b1u.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_9b1u.htm"><B>lineCompleteTransfer</B></A>, <A HREF="func1_0p0s.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_0p0s.htm"><B>lineDial</B></A>, <A HREF="func1_1i5s.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_1i5s.htm"><B>lineDrop</B></A>, <A HREF="func1_7mgc.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7mgc.htm"><B>lineMakeCall</B></A>, <A HREF="func2_4rxg.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_4rxg.htm"><B>lineSwapHold</B></A>, <A HREF="func2_2ulg.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_2ulg.htm"><B>lineUnhold</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 + -