# NCCEVN_CALL_DISCONNECTED

(unsolicited) The remote party disconnected the referenced call.

(solicited) nccDisconnectCall was invoked. The call is now disconnected from the network.

#### State transition

To disconnected call state, from any other call state. May also indicate a line state change.

#### Associated function

nccDisconnectCall, unsolicited

#### Fields

Field | Description
callhd | Call handle.
value | Contains the reason why the disconnect occurred.

#### Reason codes

Reason code | Description
NCC_DIS_BUSY | Place call received busy tone.
NCC_DIS_CED | Place call received CED detected.
NCC_DIS_CLEARDOWN_TONE | In-band remote disconnect.
NCC_DIS_CONGESTION | Place call received reorder tone.
NCC_DIS_DIAL_FAILURE | Dial failed.
NCC_DIS_DIALTONE | Place call received dialtone after dial.
NCC_DIS_GLARE | Glare detected.
NCC_DIS_HOST_TIMEOUT | Host did not respond in time.
NCC_DIS_INCOMING_FAULT | A fatal fault occurred during the setup of an incoming call. This mapping is used for protocols that do not have a protocol-specific DIS_INCOMING_FAULT value.
NCC_DIS_NO_ACKNOWLEDGEMENT | Acknowledgement of the initiation of an outbound call was not detected.
NCC_DIS_NO_CS_RESOURCE | No CS resource to place call.
NCC_DIS_NO_DIALTONE | No dialtone to dialing out (LPS).
NCC_DIS_NO_LOOP_CURRENT | No loop current to dial out (LPS).
NCC_DIS_PROTOCOL_ERROR | Disconnected on protocol error.
NCC_DIS_REJECT_REQUESTED | Call disconnected by nccRejectCall.
NCC_DIS_REMOTE_ABANDONED | Loop start inbound stopped ringing.
NCC_DIS_REMOTE_NOANSWER | Place call received no answer.
NCC_DIS_RING_BEGIN | Place call received ring begin.
NCC_DIS_RING_QUIT | Place call received ringstop (soft speaker).
NCC_DIS_SIGNAL | Normal out-of-band remote disconnect.
NCC_DIS_UNASSIGNED_NUMBER | A signal or message was detected, meaning that the called address is not allocated.
NCC_DIS_SIGNAL_UNKNOWN | An unspecified disconnect signal or message was detected.
NCC_DIS_SIT_DETECTED | Place call received SIT tone.
NCC_DIS_TIMEOUT | Place call received timeout.
NCC_DIS_TRANSFER | Transfer completed.
NCC_DIS_VOICE_BEGIN | Place call received voice detected.
NCC_DIS_VOICE_END | Place call received voice ended.
NCC_DIS_VOICE_EXTENDED | Place call received voice extended.
NCC_DIS_VOICE_LONG | Place call received voice long.
NCC_DIS_VOICE_MEDIUM | Place call received voice medium.

#### Details

NCCEVN_CALL_DISCONNECTED indicates one of the following:

- The application has invoked nccDisconnectCall.

- The remote party has hung up. This can occur in almost any call state.

- The call is inbound and the application has rejected the call.

- (ADIMGR NCC implementation only) The call is outbound, the remote party has answered, and the call has failed to meet the criteria specified by the NCC_X.ADI_PLACECALL_PARMS connectmask passed with nccPlaceCall, or has met the criteria specified by the disconnectmask.

- A call is successfully transferred using nccTransferCall or nccAutomaticTransfer (see Transferring calls).

The event value field contains the reason that the call was disconnected.

A disconnected call is no longer considered active. If there are no active calls on a line (any calls on the line are either held or disconnected), the line state returns to idle.

Use nccReleaseCall to release disconnected calls.

If the NCC_CAP_DISCONNECT_IN_ANY_STATE indicator is set in the capabilitymask for the protocol, the application can invoke nccDisconnectCall to disconnect a call regardless of the call state. In this case, a call can reach disconnected call state from any state.