📄 msgs_12ek.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>LINE_APPNEWCALL</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="LINE_APPNEWCALL">
<META NAME="MS-HAID" CONTENT="_tapi2_line_appnewcall">
</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_line_appnewcall"></A>LINE_APPNEWCALL</H1>
<P>The TAPI LINE_APPNEWCALL message is sent to inform an application when a new call handle has been spontaneously created on its behalf (other than through an API call from the application, in which case the handle would have been returned through a pointer parameter passed into the function). </P>
<PRE class=syntax>LINE_APPNEWCALL
hDevice = (DWORD) hLine;
dwCallbackInstance = (DWORD) dwInstanceData;
dwParam1 = (DWORD) dwAddressID;
dwParam2 = (DWORD) hCall;
dwParam3 = (DWORD) dwPrivilege;</PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hDevice</I> </DT>
<DD>The application's handle to the line device on which the call has been created. </DD>
<DT><I>dwCallbackInstance</I> </DT>
<DD>The callback instance supplied when opening the call's line. </DD>
<DT><I>dwParam1</I> </DT>
<DD>Identifier of the address on the line on which the call appears. An address identifier is permanently associated with an address; the identifier remains constant across operating system upgrades.</DD>
<DT><I>dwParam2</I> </DT>
<DD>The application's handle to the new call. </DD>
<DT><I>dwParam3</I> </DT>
<DD>The applications privilege to the new call (LINECALLPRIVILEGE_OWNER or LINECALLPRIVILEGE_MONITOR).
</DD>
</DL>
<H4>Return Values</H4>
<P>No return value. </P>
<H4>Remarks and Backward Compatibility</H4>
<P>Applications supporting TAPI version 2.0 or later are sent a LINE_APPNEWCALL message whenever the application is spontaneously given a handle to a new call. Because the message includes the <I>hLine</I> and <I>dwAddressID</I> parameters on which the call exists, the application can readily create a <I>new</I> call object in the correct context. The LINE_APPNEWCALL message is always immediately followed by a <A HREF="msgs_1xid.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_1xid.htm">LINE_CALLSTATE</A> message indicating the initial state of the call. </P>
<P>Older applications (that negotiated an API version earlier than 2.0) are sent only a LINE_CALLSTATE message, as documented in previous versions of the API. Such applications would create a <I>new</I> call object upon receiving a LINE_CALLSTATE message that has <I>dwParam3</I> set to a nonzero value and containing a call handle not presently known by the application. The disadvantages are that (a) the application must call <A HREF="func1_96cv.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_96cv.htm"><B>lineGetCallInfo</B></A> to determine the <I>hLine</I> and <I>dwAddressID</I> parameters associated with the call; (b) the application must scan all known call handles to determine that the call is a new call; and (c) it is possible, under certain conditions, for the application to think it is receiving a new call handle when in reality it has just deallocated its handle to the call (for example, the application has just deallocated a call handle, but a <A HREF="msgs_1xid.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_1xid.htm">LINE_CALLSTATE</A> message giving the application ownership of the call due to a <A HREF="func1_6tt2.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_6tt2.htm"><B>lineHandoff</B></A> from another application was already in the application's TAPI message queue). </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 2.0 or later.<BR>
<B> Header: </B>Declared in Tapi.h.</P>
<H4>See Also</H4>
<P><A HREF="msgs_1xid.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_1xid.htm">LINE_CALLSTATE</A>, <A HREF="func1_96cv.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_96cv.htm"><B>lineGetCallInfo</B></A>, <A HREF="func1_6tt2.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_6tt2.htm"><B>lineHandoff</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 + -