📄 func1_4a43.htm

📁 TAPI Exampple
💻 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>lineGetStatusMessages</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineGetStatusMessages">
<META NAME="MS-HAID" CONTENT="_tapi2_linegetstatusmessages">
</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_linegetstatusmessages"></A>lineGetStatusMessages</H1>

<P>The <B>lineGetStatusMessages</B> function enables an application to query which notification messages the application is set up to receive for events related to status changes for the specified line or any of its addresses. </P>

<PRE class=syntax><B>LONG WINAPI lineGetStatusMessages(
  HLINE</B><I> hLine</I><B>,             </B>
<B>  LPDWORD</B><I> lpdwLineStates</I><B>,  </B>
<B>  LPDWORD</B><I> lpdwAddressStates  </I>
<B>);</B></PRE>

<H4>Parameters</H4>

<DL>
<DT><I>hLine</I> </DT>

<DD>A handle to the line device. </DD>

<DT><I>lpdwLineStates</I> </DT>

<DD>A bit array that identifies for which line device status changes a message is to be sent to the application. If a flag is TRUE, that message is enabled; if FALSE, it is disabled. This parameter uses one or more of the <A HREF="constnts_0prn.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_0prn.htm">LINEDEVSTATE_ Constants</A>.</DD>

<DT><I>lpdwAddressStates</I> </DT>

<DD>A bit array that identifies for which address status changes a message is to be sent to the application. If a flag is TRUE, that message is enabled; if FALSE, disabled. This parameter uses one or more of the <A HREF="constnts_85bn.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_85bn.htm">LINEADDRESSSTATE_ Constants</A>. 
</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_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.</P>

<H4>Remarks</H4>

<P>TAPI defines a number of messages that notify applications about events occurring on lines and addresses. An application may not be interested in receiving all address and line status change messages. The <B>lineSetStatusMessages</B> function can be used to select which messages the application wants to receive. By default, address status and line status reporting is disabled. </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>&nbsp;&nbsp;Windows NT/2000: </B>Requires Windows NT 4.0 SP3 or later.<BR>
<B>&nbsp;&nbsp;Windows 95/98: </B>Requires Windows 95 or later.<BR>
<B>&nbsp;&nbsp;Version: </B>Requires TAPI 1.3 or later.<BR>
<B>&nbsp;&nbsp;Header: </B>Declared in Tapi.h.<BR>
<B>&nbsp;&nbsp;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_1hyd.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_1hyd.htm">LINE_CLOSE</A>, <A HREF="msgs_402t.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_402t.htm">LINE_LINEDEVSTATE</A>, <A HREF="func2_3upf.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_3upf.htm"><B>lineSetStatusMessages</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">&#169; 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 + -