📄 func1_7det.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>lineAddToConference</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineAddToConference">
<META NAME="MS-HAID" CONTENT="_tapi2_lineaddtoconference">
</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_lineaddtoconference"></A>lineAddToConference</H1>
<P>The <B>lineAddToConference</B> function adds the call specified by <I>hConsultCall</I> to the conference call specified by <I>hConfCall</I>. </P>
<PRE class=syntax><B>LONG WINAPI lineAddToConference(
HCALL</B><I> hConfCall</I><B>, </B>
<B> HCALL</B><I> hConsultCall </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hConfCall</I> </DT>
<DD>A handle to the conference call. The application must be an owner of this call. Any monitoring (media, tones, digits) on a conference call applies only to the <I>hConfCall</I>, not to the individual participating calls. Call state of <I>hConfCall</I> must be <I>onHoldPendingConference</I> or <I>onHold</I>. </DD>
<DT><I>hConsultCall</I> </DT>
<DD>A handle to the call to be added to the conference call. The application must be an owner of this call. This call cannot be a parent of another conference or a participant in any conference. Depending on the device capabilities indicated in <A HREF="struc1_5uuq.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_5uuq.htm"><B>LINEADDRESSCAPS</B></A>, the <I>hConsultCall</I> may not necessarily have been established using <A HREF="func2_7z8l.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_7z8l.htm"><B>lineSetupConference</B></A> or <A HREF="func2_8e1x.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_8e1x.htm"><B>linePrepareAddToConference</B></A>. The call state of <I>hConsultCall</I> must be <I>connected</I>, <I>onHold</I>, <I>proceeding</I>, or <I>ringback</I>. Many PBXs allow calls to be added to conferences before they are actually answered.
</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_CONFERENCEFULL, LINEERR_NOTOWNER, LINEERR_INVALCONFCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.</P>
<H4>Remarks</H4>
<P>If LINEERR_INVALCALLHANDLE is returned, the specified call handle for the added call is invalid; <I>hConsultCall</I> is a parent of another conference or already a participant in a conference; <I>hConsultCall</I> cannot be added for other reasons (such as, it must have been established using <A HREF="func2_7z8l.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_7z8l.htm"><B>lineSetupConference</B></A> or <A HREF="func2_8e1x.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_8e1x.htm"><B>linePrepareAddToConference</B></A>); or <I>hConsultCall</I> and <I>hConfCall</I> are calls on different open lines. </P>
<P>The call handle of the added party remains valid after adding the call to a conference. Its state typically changes to <I>conferenced</I> while the state of the conference call typically becomes <I>connected.</I> Using <A HREF="func1_5qlv.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_5qlv.htm"><B>lineGetConfRelatedCalls</B></A>, you can obtain a list of call handles that are part of the same conference call as the specified call. The specified call is either a conference call or a participant call in a conference call. New handles are generated for those calls for which the application does not already have handles, and the application is granted monitor privilege to those calls. The handle to an individual participating call can be used later to remove that party from the conference call using <A HREF="func2_2u91.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_2u91.htm"><B>lineRemoveFromConference</B></A>. </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>lineAddToConference</B>, it may not return a complete list of related calls 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, the conferenced state is confirmed by the service provider). After the application has received the LINE_CALLSTATE message, <B>lineGetConfRelatedCalls</B> returns complete information. </P>
<P class=note><B>Note</B> All calls that are part of a conference must exist on the same open line. </P>
<P>The call states of the calls participating in a conference are not independent. For example, when dropping a conference call, all participating calls can automatically become idle. An application should consult the line's device capabilities to determine what form of conference removal is available. The application should track the LINE_CALLSTATE messages to determine what happened to the calls involved. </P>
<P>The conference call is established either by <A HREF="func2_7z8l.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_7z8l.htm"><B>lineSetupConference</B></A> or <A HREF="func1_9b1u.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_9b1u.htm"><B>lineCompleteTransfer</B></A>. The call added to a conference is typically established using <B>lineSetupConference</B> or <A HREF="func2_8e1x.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_8e1x.htm"><B>linePrepareAddToConference</B></A>. Some switches can allow adding arbitrary calls to the conference, and such a call can have been set up using <A HREF="func1_7mgc.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7mgc.htm"><B>lineMakeCall</B></A> and be on (hard) hold. The application can examine the <B>dwAddrCapFlags</B> member of the <A HREF="struc1_5uuq.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_5uuq.htm"><B>LINEADDRESSCAPS</B></A> structure to determine the permitted operations. </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_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="struc1_5uuq.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_5uuq.htm"><B>LINEADDRESSCAPS</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_5qlv.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_5qlv.htm"><B>lineGetConfRelatedCalls</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_8e1x.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_8e1x.htm"><B>linePrepareAddToConference</B></A>, <A HREF="func2_2u91.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_2u91.htm"><B>lineRemoveFromConference</B></A>, <A HREF="func2_7z8l.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_7z8l.htm"><B>lineSetupConference</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 + -