Hold
The hold operation allows a single address to handle multiple communications sessions. Placing a session on a hard hold frees the user's line/address to make other calls. A call on hard hold typically cannot be transferred or included in a conference call, but a consultation call can. Consultation calls are initiated using conference or transfer operations.
After a call has been successfully placed on hold, the call state typically transitions to the onhold state. While a call is on hold, the application can receive messages about state changes of the held call. For example, if the held party hangs up, the call state can transition to disconnected.
In a bridged situation, the hold operation may not actually place the call on hold. The status of other stations on the call can govern (for example, attempting to "hold" a call when other stations are participating is not possible); instead, the call can simply be changed to the inactive state while it remains connected at other stations.
Not all service providers support use of this operation.
TAPI 2.x: See lineHold, lineUnhold.
TAPI 3.x: See ITBasicCallControl::Hold.