NCCEVN_CALL_RETRIEVED

(solicited) The application retrieved a call it placed on hold.

(unsolicited) A call was retrieved by this unsolicited event.

State transition

To active line state, from idle line state.

Associated function

nccRetrieveCall, nccAutomaticTransfer, unsolicited

Fields

Field	Description
callhd	Call handle.

Reason codes

Reason code	Description
NCC_DIS_xxx	Signifies that an automatic transfer failed. For a list of valid values, see NCCEVN_CALL_DISCONNECTED.

Details

NCCEVN_CALL_RETRIEVED indicates that a call on hold was retrieved either by the application or by a remote party. The call is now active. Since there is an active call on the line, the line state changes to active.

Call hold/retrieve is not supported by all protocols. NCC_CAP_HOLD_CALL in the capabilitymask returned by nccQueryCapability indicates if the current protocol supports this capability or not.

The application can invoke nccGetCallStatus to determine whether a call is on hold or not. If a call is on hold, the held field in the NCC_CALL_STATUS structure returned for that call contains a non-zero value.