📄 func1_3w6c.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>lineGetAddressID</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineGetAddressID">
<META NAME="MS-HAID" CONTENT="_tapi2_linegetaddressid">
</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_linegetaddressid"></A>lineGetAddressID</H1>
<P>The <B>lineGetAddressID</B> function returns the address identifier associated with an address in a different format on the specified line. </P>
<PRE class=syntax><B>LONG WINAPI lineGetAddressID(
HLINE</B><I> hLine</I><B>, </B>
<B> LPDWORD</B><I> lpdwAddressID</I><B>, </B>
<B> DWORD</B><I> dwAddressMode</I><B>, </B>
<B> LPCSTR</B><I> lpsAddress</I><B>, </B>
<B> DWORD</B><I> dwSize </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hLine</I> </DT>
<DD>A handle to the open line device. </DD>
<DT><I>lpdwAddressID</I> </DT>
<DD>A pointer to a <B>DWORD</B>-sized memory location where the address identifier is returned. An address identifier is permanently associated with an address; the identifier remains constant across operating system upgrades.</DD>
<DT><I>dwAddressMode</I> </DT>
<DD>The address mode of the address contained in <I>lpsAddress</I>. This parameter uses one and only one of the <A HREF="constnts_5ib7.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/constnts_5ib7.htm">LINEADDRESSMODE_ Constants</A>. You must specify LINEADDRESSMODE_DIALABLEADDR.
</DD>
<DT><I>lpsAddress</I> </DT>
<DD>A pointer to a data structure holding the address assigned to the specified line device. The format of the address is determined by <I>dwAddressMode</I>. Because the only valid value is LINEADDRESSMODE_DIALABLEADDR, <I>lpsAddress</I> uses the common dialable number format and is null-terminated. </DD>
<DT><I>dwSize</I> </DT>
<DD>The size of the address contained in <I>lpsAddress</I>.
</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_OPERATIONUNAVAIL, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_NOMEM. </P>
<H4>Remarks</H4>
<P>The <B>lineGetAddressID</B> function is used to map a phone number (address) assigned to a line device back to its <I>dwAddressID</I> in the range zero to the number of addresses minus one returned in the line's device capabilities. The <A HREF="func1_7mgc.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7mgc.htm"><B>lineMakeCall</B></A> function allows the application to make a call by specifying a line handle and an address on the line. The address can be specified as a <I>dwAddressID</I>, as a phone number, or as a device-specific name or identifier. Using a phone number can be practical in environments where a single line is assigned multiple addresses. </P>
<P class=note><B>Note</B> LINEADDRESSMODE_ADDRESSID may not be used with <B>lineGetAddressID</B>. </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.<BR>
<B> Unicode: </B>Implemented as Unicode and ANSI versions on all platforms.</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="func1_7mgc.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7mgc.htm"><B>lineMakeCall</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 + -