?? func2_34by.htm
字號(hào):
<!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>lineOpen</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineOpen">
<META NAME="MS-HAID" CONTENT="_tapi2_lineopen">
</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_lineopen"></A>lineOpen</H1>
<P>The <B>lineOpen</B> function opens the line device specified by its device identifier and returns a line handle for the corresponding opened line device. This line handle is used in subsequent operations on the line device. </P>
<PRE class=syntax><B>LONG WINAPI lineOpen(
HLINEAPP</B><I> hLineApp</I><B>, </B>
<B> DWORD</B><I> dwDeviceID</I><B>, </B>
<B> LPHLINE</B><I> lphLine</I><B>, </B>
<B> DWORD</B><I> dwAPIVersion</I><B>, </B>
<B> DWORD</B><I> dwExtVersion</I><B>, </B>
<B> DWORD_PTR</B><I> dwCallbackInstance</I><B>, </B>
<B> DWORD</B><I> dwPrivileges</I><B>, </B>
<B>DWORD</B> <I>dwMediaModes</I><B>, </B>
<B> LPLINECALLPARAMS const</B><I> lpCallParams </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hLineApp</I> </DT>
<DD>A handle to the application's registration with TAPI. </DD>
<DT><I>dwDeviceID</I> </DT>
<DD>Identifies the line device to be opened. It can either be a valid device identifier or the value:
<DL>
<DT>LINEMAPPER </DT>
<DD>This value is used to open a line device in the system that supports the properties specified in <I>lpCallParams</I>. The application can use <A HREF="func1_2gf8.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_2gf8.htm"><B>lineGetID</B></A> to determine the identifier of the line device that was opened.
</DD>
</DL>
</DD>
<DT><I>lphLine</I> </DT>
<DD>A pointer to an HLINE handle that is then loaded with the handle representing the opened line device. Use this handle to identify the device when invoking other functions on the open line device. </DD>
<DT><I>dwAPIVersion</I> </DT>
<DD>The API version number under which the application and Telephony API have agreed to operate. This number is obtained with <A HREF="func2_9kxa.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_9kxa.htm"><B>lineNegotiateAPIVersion</B></A>. </DD>
<DT><I>dwExtVersion</I> </DT>
<DD>The extension version number under which the application and the service provider agree to operate. This number is zero if the application does not use any extensions. This number is obtained with <A HREF="func2_3p66.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_3p66.htm"><B>lineNegotiateExtVersion</B></A>. </DD>
<DT><I>dwCallbackInstance</I> </DT>
<DD>User-instance data passed back to the application with each message associated with this line or with addresses or calls on this line. This parameter is not interpreted by the Telephony API. </DD>
<DT><I>dwPrivileges</I> </DT>
<DD>The privilege the application wants when notified of a call This parameter contains one or more of the <A HREF="constnts_4777.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_4777.htm">LINECALLPRIVILEGE_ Constants</A>. For applications using TAPI version 2.0 or later, values for this parameter can also be combined with one or more of the <A HREF="constnts_4sxf.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_4sxf.htm">LINEOPENOPTION_ Constants</A>.
<P>If the LINEOPENOPTION_SINGLEADDRESS option is specified, then the application is interested only in new calls that appear on the address specified by the <B>dwAddressID</B> member in the <A HREF="struc1_904y.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_904y.htm"><B>LINECALLPARAMS</B></A> structure pointed to by the <I>lpCallParams</I> parameter (which must be specified).
<P>If LINEOPENOPTION_SINGLEADDRESS is specified but either <I>lpCallParams</I> is invalid or the included <B>dwAddressID</B> does not exist on the line, the open fails with LINERR_INVALADDRESSID.
<P>In addition to setting the <B>dwAddressID</B> member of the <B>LINECALLPARAMS</B> structure to the desired address, the application must also set <B>dwAddressMode</B> in <B>LINECALLPARAMS</B> to LINEADDRESSMODE_ADDRESSID.
?? 快捷鍵說(shuō)明
復(fù)制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號(hào)
Ctrl + =
減小字號(hào)
Ctrl + -