This function retrieves the specified held call.
Note This function is for TAPI version 2.0 and later.
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 Values
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
OS Versions: Windows CE 1.0 and later.
Header: Tapi.h.
Link Library: Coredll.lib.
See Also
Send Feedback on this topic to the authors