?? func2_6do0.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>linePickup</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="linePickup">
<META NAME="MS-HAID" CONTENT="_tapi2_linepickup">
</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_linepickup"></A>linePickup</H1>
<P>The <B>linePickup</B> function picks up a call alerting at the specified destination address and returns a call handle for the picked-up call. If invoked with NULL for the <I>lpszDestAddress</I> parameter, a group pickup is performed. If required by the device, <I>lpszGroupID</I> specifies the group identifier to which the alerting station belongs. </P>
<PRE class=syntax><B>LONG WINAPI linePickup(
HLINE</B><I> hLine</I><B>, </B>
<B> DWORD</B><I> dwAddressID</I><B>, </B>
<B> LPHCALL</B><I> lphCall</I><B>, </B>
<B> LPCSTR</B><I> lpszDestAddress</I><B>, </B>
<B> LPCSTR</B><I> lpszGroupID </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>hLine</I> </DT>
<DD>A handle to the open line device on which a call is to be picked up. </DD>
<DT><I>dwAddressID</I> </DT>
<DD>The address on <I>hLine</I> at which the pickup is to be originated. An address identifier is permanently associated with an address; the identifier remains constant across operating system upgrades.</DD>
<DT><I>lphCall</I> </DT>
<DD>A pointer to a memory location where the handle to the picked up call is returned. The application is the initial sole owner of the call. </DD>
<DT><I>lpszDestAddress</I> </DT>
<DD>A pointer to a null-terminated character buffer that contains the address whose call is to be picked up. The address is in standard dialable address format. </DD>
<DT><I>lpszGroupID</I> </DT>
<DD>A pointer to a null-terminated character buffer containing the group identifier to which the alerting station belongs. This parameter is required on some switches to pick up calls outside of the current pickup group.
<P>The <I>lpszGroupID</I> parameter can be specified by itself with a NULL pointer for <I>lpszDestAddress</I>. Alternatively, <I>lpszGroupID</I> can be specified in addition to <I>lpszDestAddress</I>, if required by the device.
</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_INVALADDRESS, LINEERR_NOMEM, LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALGROUPID, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED.</P>
<H4>Remarks</H4>
<P>When a call has been picked up successfully, the application is notified by the <A HREF="msgs_1xid.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/msgs_1xid.htm">LINE_CALLSTATE</A> message about call state changes. The <A HREF="struc1_4oky.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_4oky.htm"><B>LINECALLINFO</B></A> structure supplies information about the call that was picked up. It lists the reason for the call as <I>pickup</I>. This structure is available using <A HREF="func1_96cv.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_96cv.htm"><B>lineGetCallInfo</B></A>. </P>
<P>If LINEADDRCAPFLAGS_PICKUPCALLWAIT is TRUE, <B>linePickup</B> can be used to pick up a call for which the user has audibly detected the call-waiting signal but for which the provider is unable to perform the detection. This gives the user a mechanism to "answer" a waiting call even though the service provider was unable to detect the call-waiting signal. Both <I>lpszDestAddress</I> and <I>lpszGroupID</I> pointer parameters must be NULL to pick up a call-waiting call. The <B>linePickup</B> function creates a new call handle for the waiting call and passes that handle to the user. The <I>dwAddressID</I> parameter is most often zero (particularly in single-line residential cases). </P>
<P>After <B>linePickup</B> has been used to pick up the second call, <A HREF="func2_4rxg.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_4rxg.htm"><B>lineSwapHold</B></A> can be used to toggle between them. The <A HREF="func1_1i5s.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_1i5s.htm"><B>lineDrop</B></A> function can be used to drop one (and toggle to the other), and so forth. If the user wants to drop the current call and pick up the second call, they should call <B>lineDrop</B> when they get the call-waiting beep, wait for the second call to ring, and then call <A HREF="func1_52nm.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_52nm.htm"><B>lineAnswer</B></A> on the new call handle. The LINEADDRFEATURE_PICKUP flag in the <B>dwAddressFeatures</B> member in <A HREF="struc1_848i.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_848i.htm"><B>LINEADDRESSSTATUS</B></A> indicates when pickup is actually possible. </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_3436.htm \n\n這個文件不能通過 Teleport Pro 取回, 因為 地址在一個域或為它的開始地址設定的邊界的外部路徑上. \n\n你想從服務器打開它嗎?'))window.location='http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_3436.htm'" tppabs="http://msdn.microsoft.com/library/psdk/tapi3/tapiovr2_3436.htm">Pickup</A> Overview, <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_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="struc1_848i.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_848i.htm"><B>LINEADDRESSSTATUS</B></A>, <A HREF="func1_52nm.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_52nm.htm"><B>lineAnswer</B></A>, <A HREF="struc1_4oky.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/struc1_4oky.htm"><B>LINECALLINFO</B></A>, <A HREF="func1_1i5s.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_1i5s.htm"><B>lineDrop</B></A>, <A HREF="func1_96cv.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func1_96cv.htm"><B>lineGetCallInfo</B></A>, <A HREF="func2_4rxg.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_4rxg.htm"><B>lineSwapHold</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 + -