?? func1_1s4y.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>lineAddProvider</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="lineAddProvider">
<META NAME="MS-HAID" CONTENT="_tapi2_lineaddprovider">
</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_lineaddprovider"></A>lineAddProvider</H1>
<P>The <B>lineAddProvider</B> function installs a new telephony service provider into the telephony system. </P>
<PRE class=syntax><B>LONG WINAPI lineAddProvider(
LPCSTR</B><I> lpszProviderFilename</I><B>, </B>
<B> HWND</B><I> hwndOwner</I><B>, </B>
<B> LPDWORD</B><I> lpdwPermanentProviderID </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>lpszProviderFilename</I> </DT>
<DD>A pointer to a null-terminated string containing the path of the service provider to be added. </DD>
<DT><I>hwndOwner</I> </DT>
<DD>A handle to a window in which any dialog boxes that need to be displayed as part of the installation process (for example, by the service provider's <A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/tspi21/func1_0f3g.htm \n\n這個文件不能通過 Teleport Pro 取回, 因為 地址在一個域或為它的開始地址設定的邊界的外部路徑上. \n\n你想從服務器打開它嗎?'))window.location='http://msdn.microsoft.com/library/psdk/tspi21/func1_0f3g.htm'" tppabs="http://msdn.microsoft.com/library/psdk/tspi21/func1_0f3g.htm"><B>TSPI_providerInstall</B></A> function) would be attached. Can be NULL to indicate that any window created during the function should have no owner window. </DD>
<DT><I>lpdwPermanentProviderID</I> </DT>
<DD>A pointer to a <B>DWORD</B>-sized memory location into which TAPI writes the permanent provider identifier of the newly installed service provider.
</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_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALPARAM, LINEERR_NOMULTIPLEINSTANCE, LINEERR_INVALPOINTER, LINEERR_OPERATIONFAILED.</P>
<H4>Remarks</H4>
<P>During this function call, TAPI checks to ensure that it can access the service provider by calling its <A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/tspi21/func1_0f3g.htm \n\n這個文件不能通過 Teleport Pro 取回, 因為 地址在一個域或為它的開始地址設定的邊界的外部路徑上. \n\n你想從服務器打開它嗎?'))window.location='http://msdn.microsoft.com/library/psdk/tspi21/func1_0f3g.htm'" tppabs="http://msdn.microsoft.com/library/psdk/tspi21/func1_0f3g.htm"><B>TSPI_providerInstall</B></A> function; if this is unsuccessful (if the DLL or function cannot be found, or if <B>TSPI_providerInstall</B> returns an error), the function fails and the provider is not added to the telephony system. If this succeeds, and the Win32 Telephony system is active (one or more applications have called <A HREF="func1_26lh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_26lh.htm"><B>lineInitialize</B></A> or <A HREF="func1_2o54.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_2o54.htm"><B>lineInitializeEx</B></A>), TAPI does not attempt to launch the newly-added service provider. Instead, in order to activate the new service provider, TAPI issues a message to restart Windows. When the activation succeeds, applications are informed of any new devices created by way of <A HREF="msgs_5qlh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_5qlh.htm">LINE_CREATE</A> or <A HREF="msgs_6ig5.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_6ig5.htm">PHONE_CREATE</A> messages, or by a <A HREF="msgs_402t.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_402t.htm">LINE_LINEDEVSTATE</A> message requesting reinitialization (if the application does not support the CREATE messages). </P>
<P>This function copies no files梟ot the service provider DLL itself nor any supporting files; the application managing the addition of the provider must ensure that the provider is installed in a directory where it can be found by TAPI (for example, \WINDOWS, \WINDOWS\SYSTEM, or elsewhere on the path). </P>
<P>Although this is a new function that older applications would not be expected to call, for backward compatibility they should not be prevented from doing so; the function works the same way for all applications. </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.4 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_6gvn.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/quickref_6gvn.htm">Supplementary Line Service Functions</A>, <A HREF="msgs_5qlh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_5qlh.htm">LINE_CREATE</A>, <A HREF="msgs_402t.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_402t.htm">LINE_LINEDEVSTATE</A>, <A HREF="func1_26lh.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_26lh.htm"><B>lineInitialize</B></A>, <A HREF="func1_2o54.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_2o54.htm"><B>lineInitializeEx</B></A>, <A HREF="msgs_6ig5.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_6ig5.htm">PHONE_CREATE</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 + -