TSPI_lineUnhold function (tspi.h)
The TSPI_lineUnhold function retrieves the specified held call.
Syntax
LONG TSPIAPI TSPI_lineUnhold(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall
);
Parameters
dwRequestID
The identifier of the asynchronous request.
hdCall
The handle to the call to be retrieved. The call state of hdCall can be onHold.
Return value
Returns dwRequestID, or an error number if an error occurs. The lResult actual parameter of the corresponding ASYNC_COMPLETION is zero if the function succeeds, or an error number if an error occurs. Possible return values are as follows:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
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 TSPI_lineHold) 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 LINECALLSTATE message for the new call state.
Requirements
Requirement | Value |
---|---|
Target Platform | Windows |
Header | tspi.h |
See also
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for