📄 func1_5qlv.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>lineGetConfRelatedCalls</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineGetConfRelatedCalls">
<META NAME="MS-HAID" CONTENT="_tapi2_linegetconfrelatedcalls">
</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_linegetconfrelatedcalls"></A>lineGetConfRelatedCalls</H1>
<P>The <B>lineGetConfRelatedCalls </B>function returns 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. </P>
<PRE class=syntax><B>LONG WINAPI lineGetConfRelatedCalls(
HCALL</B><I> hCall</I><B>, </B>
<B> LPLINECALLLIST</B><I> lpCallList </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hCall</I> </DT>
<DD>A handle to a call. This is either a conference call or a participant call in a conference call. For a conference parent call, the call state of <I>hCall</I> can be any state. For a conference participant call, it must be in the <I>conferenced</I> state. </DD>
<DT><I>lpCallList</I> </DT>
<DD>A pointer to a variably sized data structure of type <A HREF="struc1_101e.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_101e.htm"><B>LINECALLLIST</B></A>. Upon successful completion of the request, call handles to all calls in the conference call are returned in this structure. The first call in the list is the conference call, the other calls are the participant calls. The application is granted monitor privilege to those calls for which it does not already have handles; the privileges to calls in the list for which the application already has handles is unchanged. Prior to calling <B>lineGetConfRelatedCalls</B>, the application should set the <B>dwTotalSize</B> member of this structure to indicate the amount of memory available to TAPI for returning information.
</DD>
</DL>
<H4>Return Values</H4>
<P>Returns zero if the request succeeds or a negative error number if an error occurs. Possible return values are: </P>
<P>LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOCONFERENCE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.</P>
<H4>Remarks</H4>
<P>The specified call can either be a conference call handle or a handle to a participant call. For example, a consultation call that has not yet been added to a conference call is not part of a conference. The first entry in the list that is returned is the conference call handle, the other handles are all the participant calls. The specified call is always one of the calls returned in the list. Calls in the list to which the application does not already have a call handle are assigned monitor privilege; privileges to calls for which the application already has handles are unchanged. The application can use <A HREF="func2_34px.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_34px.htm"><B>lineSetCallPrivilege</B></A> to change the privilege of the call. </P>
<P>If <B>lineGetConfRelatedCalls</B> is called immediately after a call is added to a conference using <A HREF="func1_9b1u.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_9b1u.htm"><B>lineCompleteTransfer</B></A>, <B>lineGetConfRelatedCalls</B> 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 <I>conferenced</I> state is confirmed by the service provider). After the application has received the LINE_CALLSTATE message, <B>lineGetConfRelatedCalls</B> returns complete information. </P>
<P>The application can invoke <A HREF="func1_96cv.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_96cv.htm"><B>lineGetCallInfo</B></A> and <A HREF="func1_7iur.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7iur.htm"><B>lineGetCallStatus</B></A> for each call in the list to determine the call's information and status, respectively. </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="quickref_1okl.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/quickref_1okl.htm">TAPI 2.2 Reference Overview</A>, <A HREF="quickref_1pnp.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/quickref_1pnp.htm">Basic Telephony Services Reference</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="func1_96cv.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_96cv.htm"><B>lineGetCallInfo</B></A>, <A HREF="func1_7iur.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7iur.htm"><B>lineGetCallStatus</B></A>, <A HREF="func2_34px.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_34px.htm"><B>lineSetCallPrivilege</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 + -