📄 func1_0p0s.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>lineDial</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineDial">
<META NAME="MS-HAID" CONTENT="_tapi2_linedial">
</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_linedial"></A>lineDial</H1>
<P>The <B>lineDial</B> function dials the specified dialable number on the specified call. </P>
<PRE class=syntax><B>LONG WINAPI lineDial(
HCALL</B><I> hCall</I><B>, </B>
<B> LPCSTR</B><I> lpszDestAddress</I><B>, </B>
<B> DWORD</B><I> dwCountryCode </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hCall</I> </DT>
<DD>A handle to the call on which a number is to be dialed. The application must be an owner of the call. The call state of <I>hCall</I> can be any state except <I>idle</I> and <I>disconnected</I>. </DD>
<DT><I>lpszDestAddress</I> </DT>
<DD>The destination to be dialed using the standard dialable number format. </DD>
<DT><I>dwCountryCode</I> </DT>
<DD>The country code of the destination. This is used by the implementation to select the call progress protocols for the destination address. If a value of 0 is specified, a service provider-defined default call progress protocol is used.
</DD>
</DL>
<H4>Return Values</H4>
<P>Returns a positive request identifier if the function is completed asynchronously, or a negative error number if an error occurs. The <I>dwParam2</I> parameter of the corresponding <A HREF="msgs_65mh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_65mh.htm">LINE_REPLY</A> message is zero if the function succeeds or it is a negative error number if an error occurs. Possible return values are: </P>
<P>LINEERR_ADDRESSBLOCKED, LINEERR_INVALPOINTER, LINEERR_DIALBILLING, LINEERR_NOMEM, LINEERR_DIALDIALTONE, LINEERR_NOTOWNER, LINEERR_DIALPROMPT, LINEERR_OPERATIONFAILED, LINEERR_DIALQUIET, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_UNINITIALIZED, LINEERR_INVALCOUNTRYCODE.</P>
<H4>Remarks</H4>
<P>If LINEERR_INVALADDRESS is returned, no dialing has been done. If LINEERR_DIALBILLING, LINEERR_DIALQUIET, LINEERR_DIALDIALTONE, or LINEERR_DIALPROMPT is returned, none of the actions otherwise performed by <B>lineDial</B> have occurred. For example, none of the dialable addresses prior to the offending character has been dialed, no hookswitch state has changed, and so on. </P>
<P>The <B>lineDial</B> function is used for dialing on an existing call appearance. For example, after a call has been set up for transfer or conference, a consultation call is automatically allocated, and the <B>lineDial</B> function would be used to perform the dialing of this consultation call. The <B>lineDial</B> function can be invoked multiple times in the course of multistage dialing, if the line's device capabilities allow it. Also, multiple addresses can be provided in a single dial string separated by CRLF. Service providers that provide inverse multiplexing can establish individual physical calls with each of the addresses and can return a single call handle to the aggregate of all calls to the application. All addresses would use the same country code. </P>
<P>Dialing is considered complete after the address has been passed to the service provider; not after the call is finally connected. Service providers that provide inverse multiplexing can allow multiple addresses to be provided at once. The service provider sends LINE_CALLSTATE messages to the application to inform it about the progress of the call. To abort a call attempt while a call is being established, the invoking application should use <A HREF="func1_1i5s.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_1i5s.htm"><B>lineDrop</B></A>. </P>
<P>An application can set the <I>lpszDestAddress</I> parameter of the <B>lineDial</B> function to the address of an empty string to indicate that dialing is complete, but only if the previous calls to the <A HREF="func1_7mgc.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_7mgc.htm"><B>lineMakeCall</B></A> and <B>lineDial</B> functions have had the strings specified by <I>lpszDestAddress</I> terminated with semicolons. </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="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_0s4y.htm \n\n这个文件不能通过 Teleport Pro 取回, 因为 地址在一个域或为它的开始地址设定的边界的外部路径上. \n\n你想从服务器打开它吗?'))window.location='http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_0s4y.htm'" tppabs="http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_0s4y.htm">Dial Overview</A>, <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="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_3ib6.htm \n\n这个文件不能通过 Teleport Pro 取回, 因为 地址在一个域或为它的开始地址设定的边界的外部路径上. \n\n你想从服务器打开它吗?'))window.location='http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_3ib6.htm#_tapi3_dialable_addresses'" tppabs="http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_3ib6.htm#_tapi3_dialable_addresses">Dialable Addresses</A>, <A HREF="msgs_1xid.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_1xid.htm">LINE_CALLSTATE</A>, <A HREF="msgs_65mh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_65mh.htm">LINE_REPLY</A>, <A HREF="func1_1i5s.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_1i5s.htm"><B>lineDrop</B></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 + -