Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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