lineUnhold (Compact 2013)

3/26/2014

This function retrieves the specified held call.

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

TAPI32.dll

See Also

Reference

TAPI Line Device Functions
LINE_REPLY
LINECALLSTATE