See Also
 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function retrieves the specified held call.
Syntax
LONG TSPIAPI TSPI_lineUnhold( DRV_REQUESTID dwRequestID, HDRVCALL hdCall ); |
Parameters
- dwRequestID
-
Identifier of the asynchronous request.
- hdCall
-
Handle to the call to be retrieved. The call state of hdCallcan be onHold.
Return Value
Returns dwRequestID, or an error number if an error occurs. The lResultactual parameter of the corresponding ASYNC_COMPLETIONis zero if the function succeeds, or an error number if an error occurs. The following table shows the return values for this method.
| Value | Description |
|---|---|
|
LINEERR_INVALCALLHANDLE |
The handle to the call is invalid. |
|
LINEERR_OPERATIONUNAVAIL, |
The operation is unavailable. |
|
LINEERR_INVALCALLSTATE |
The call state is invalid. |
|
LINEERR_OPERATIONFAILED |
The operation failed. |
|
LINEERR_NOMEM |
Not enough memory is available. |
|
LINEERR_RESOURCEUNAVAIL |
The resource is unavailable. |
Remarks
The service provider returns LINEERR_INVALCALLSTATE if the call is not currently on hold.
This operation works for calls on hard hold (calls placed on hold using the TSPI_lineHoldfunction) and on soft hold. The service provider should check that the call is currently in the onHold, onHoldPendingTransfer, or onHoldPendingConference state, change the state to connected, and send a LINECALLSTATEmessage for the new call state.
Requirements
| Header | tapicomn.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |