Skip to content

Latest commit

 

History

History
87 lines (65 loc) · 2.63 KB

nf-tapi-lineswaphold.md

File metadata and controls

87 lines (65 loc) · 2.63 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:tapi.lineSwapHold
lineSwapHold function (tapi.h)
The lineSwapHold function swaps the specified active call with the specified call on consultation hold.
_tapi2_lineswaphold
lineSwapHold
lineSwapHold function [TAPI 2.2]
tapi/lineSwapHold
tapi2.lineswaphold
tapi2\lineswaphold.htm
tapi3
9e575c82-301c-4505-b400-faf4dc291ff8
12/05/2018
_tapi2_lineswaphold, lineSwapHold, lineSwapHold function [TAPI 2.2], tapi/lineSwapHold, tapi2.lineswaphold
tapi.h
Windows
Tapi32.lib
Tapi32.dll
Windows
19H1
lineSwapHold
tapi/lineSwapHold
c++
APIRef
kbSyntax
DllExport
Tapi32.dll
lineSwapHold

lineSwapHold function

-description

The lineSwapHold function swaps the specified active call with the specified call on consultation hold.

-parameters

-param hActiveCall

Handle to the active call. The application must be an owner of the call. The call state of hActiveCall must be connected.

-param hHeldCall

Handle to the consultation call. The application must be an owner of the call. The call state of hHeldCall can be onHoldPendingTransfer, onHoldPendingConference, or onHold.

-returns

Returns a positive request identifier if the function is completed asynchronously, or a negative error number if an error occurs. The dwParam2 parameter of the corresponding LINE_REPLY message is zero if the function succeeds or it is a negative error number if an error occurs. Possible return values are:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED.

-remarks

Swapping the active call with the call on consultation hold allows the application to alternate or toggle between these two calls. This is typical in call waiting.

-see-also

LINE_REPLY

Supplementary Line Service Functions

TAPI 2.2 Reference Overview