lineUnhold
A version of this page is also available for
4/8/2010
This function retrieves the specified held call.
Note
This function is for TAPI version 2.0 and later.
Syntax
LONG WINAPI lineUnhold(
HCALL hCall
);
Parameters
hCall
Handle to the call to be retrieved. The application must be an owner of this call. The call state of hCall must be LINECALLSTATE_ONHOLD.See LINECALLSTATE for more information about LINECALLSTATE_ONHOLD.
Return Value
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. The following table shows the return values for this function.
| Value | Description |
|---|---|
LINEERR_INVALCALLHANDLE |
The handle to the call is invalid. |
LINEERR_OPERATIONUNAVAIL |
The operation is unavailable. |
LINEERR_INVALCALLSTATE |
The call state of hCall is something other than onHold, onHoldPendingTransfer, or onHoldPendingConference. |
LINEERR_OPERATIONFAILED |
The operation failed. |
LINEERR_NOMEM |
Not enough memory is available. |
LINEERR_RESOURCEUNAVAIL |
The resources are unavailable. |
LINEERR_NOTOWNER |
The application is not an owner of this call. |
LINEERR_UNINITIALIZED |
A parameter is uninitialized. |
Requirements
| Header | tapi.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |