?? func2_7z8l.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>lineSetupConference</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineSetupConference">
<META NAME="MS-HAID" CONTENT="_tapi2_linesetupconference">
</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_linesetupconference"></A>lineSetupConference</H1>
<P>The <B>lineSetupConference</B> function sets up a conference call for the addition of the third party. </P>
<PRE class=syntax><B>LONG WINAPI lineSetupConference(
HCALL</B><I> hCall</I><B>, </B>
<B>HLINE</B> <I>hLine</I><B>, </B>
<B> LPHCALL</B><I> lphConfCall</I><B>, </B>
<B> LPHCALL</B><I> lphConsultCall</I><B>, </B>
<B> DWORD</B><I> dwNumParties</I><B>, </B>
<B> LPLINECALLPARAMS const</B><I> lpCallParams </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hCall</I> </DT>
<DD>The initial call that identifies the first party of a conference call. In some environments (as described in device capabilities), a call must exist to start a conference call, and the application must be an owner of this call. In other telephony environments, no call initially exists, <I>hCall</I> must be left NULL, and <I>hLine</I> must be specified to identify the line on which the conference call is to be initiated. The call state of <I>hCall</I> must be <I>connected</I>. </DD>
<DT><I>hLine</I> </DT>
<DD>A handle to the line. This handle is used to identify the line device on which to originate the conference call if <I>hCall</I> is NULL. The <I>hLine</I> parameter is ignored if <I>hCall</I> is non-NULL. </DD>
<DT><I>lphConfCall</I> </DT>
<DD>A pointer to an HCALL handle. This location is then loaded with a handle identifying the newly created conference call. The application is the initial sole owner of this call. The call state of <I>hConfCall</I> is not applicable. </DD>
<DT><I>lphConsultCall</I> </DT>
<DD>A pointer to an HCALL handle. When setting up a call for the addition of a new party, a new temporary call (consultation call) is automatically allocated. Initially, the application is the sole owner for this call. </DD>
<DT><I>dwNumParties</I> </DT>
<DD>The expected number of parties in the conference call. This number is passed to the service provider. The service provider is free to do as it pleases with this number: ignore it, use it as a hint to allocate the right size conference bridge inside the switch, and so on. </DD>
<DT><I>lpCallParams</I> </DT>
<DD>A pointer to call parameters to be used when establishing the consultation call. This parameter can be set to NULL if no special call setup parameters are desired.
</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 LINE_REPLY 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_UNINITIALIZED, LINEERR_CALLUNAVAIL, LINEERR_INVALMEDIAMODE, LINEERR_CONFERENCEFULL, LINEERR_INVALPOINTER, LINEERR_INUSE, LINEERR_INVALRATE, LINEERR_INVALADDRESSMODE, LINEERR_NOMEM, LINEERR_INVALBEARERMODE, LINEERR_NOTOWNER, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLPARAMS, LINEERR_RATEUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_STRUCTURETOOSMALL, LINEERR_USERUSERINFOTOOBIG. </P>
<H4>Remarks</H4>
<P>If LINEERR_INVALLINESTATE is returned, the line is currently not in a state in which this operation can be performed. A list of currently valid operations can be found in the <B>dwLineFeatures</B> member (of the type <A HREF="constnts_8a9f.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_8a9f.htm"><B>LINEFEATURE</B></A>) in the <A HREF="struc2_40oi.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_40oi.htm"><B>LINEDEVSTATUS</B></A> structure. (Calling <A HREF="func1_4377.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_4377.htm"><B>lineGetLineDevStatus</B></A> updates the information in <B>LINEDEVSTATUS</B>.) If LINEERR_INVALMEDIAMODE is returned, check for supported media types on the line in the <B>dwMediaModes</B> member in the <A HREF="struc2_67aq.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_67aq.htm"><B>LINEDEVCAPS</B></A> structure. </P>
<P>The <B>lineSetupConference</B> function provides two ways to establish a new conference call, depending on whether a normal two-party call is required to pre-exist or not. When setting up a conference call from an existing two-party call, the <I>hCall</I> parameter is a valid call handle that is initially added to the conference call by the <B>lineSetupConference</B> request; <I>hLine</I> is ignored. On switches where conference call setup does not start with an existing call, <I>hCall</I> must be NULL and <I>hLine</I> must be specified to identify the line device on which to initiate the conference call. In either case, a consultation call is allocated for connecting to the party that is to be added to the call. The application can then use <A HREF="func1_0p0s.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_0p0s.htm"><B>lineDial</B></A> to dial the address of the other party. </P>
<P>The conference call typically transitions into the <I>onHoldPendingConference</I> state, the consultation call into the <I>dialtone</I> state, and the initial call (if there is one) into the <I>conferenced</I> state. </P>
<P>A conference call can also be set up by a <A HREF="func1_9b1u.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_9b1u.htm"><B>lineCompleteTransfer</B></A> that is resolved into a three-way conference. The application may be able to toggle between the consultation call and the conference call using <A HREF="func2_4rxg.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_4rxg.htm"><B>lineSwapHold</B></A>. </P>
<P>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. When dropping a consultation call, the existing conference call typically transitions back to the <I>connected</I> state. The application should observe the LINE_CALLSTATE messages to determine exactly what happens to the calls. For example, if the conference call reverts back to a regular two-party call, the conference call becomes idle and the original participant call can revert to <I>connected</I>. </P>
<P>If an application specifies the handle of the original call (<I>hCall</I>) in a call to the <A HREF="func2_2ulg.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_2ulg.htm"><B>lineUnhold</B></A> function, both the conference call and the consultation call typically go to idle. </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_4mb6.htm \n\n這個文件不能通過 Teleport Pro 取回, 因為 地址在一個域或為它的開始地址設定的邊界的外部路徑上. \n\n你想從服務器打開它嗎?'))window.location='http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_4mb6.htm'" tppabs="http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_4mb6.htm">Conference</A> Overview, <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="func1_9b1u.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_9b1u.htm"><B>lineCompleteTransfer</B></A>, <A HREF="struc2_67aq.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_67aq.htm"><B>LINEDEVCAPS</B></A>, <A HREF="struc2_40oi.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc2_40oi.htm"><B>LINEDEVSTATUS</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_4377.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_4377.htm"><B>lineGetLineDevStatus</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 + -