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

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.