NCC events without ADI counterparts

The following table lists NCC events that do not have counterparts in ADI. All listed events are informational:

Event

Contains

Associated function

Description

NCCEVN_BLOCK_FAILED

linehd, value

nccBlockCalls

A request to block calls on a line failed.

NCCEVN_CALL_HELD

callhd

nccHoldCall,

nccAutomaticTransfer,

unsolicited

(solicited) nccHoldCall or nccAutomaticTransfer invoked, call is now held.

(unsolicited) The CPE has placed call on hold.

held field in call status structure is set to a non-zero value.

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.

NCCEVN_CALL_RETRIEVED

callhd

nccHoldCall,

nccAutomaticTransfer,

unsolicited

(solicited) Application has retrieved a call it placed on hold and the network has agreed.

(unsolicited) Call retrieved via this unsolicited event.

held field in call status structure is set to zero.

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.

NCCEVN_CALLID_AVAILABLE

callhd

unsolicited

A call identifier is available. Application can invoke nccTransferCall to perform a two channel call transfer.

NCCEVN_CAPABILITY_UPDATE

ctahd, value

unsolicited

Protocol capabilities have changed. The application can invoke nccQueryCapability to determine the current set of protocol capabilities.

NCCEVN_EXTENDED_CALL_
STATUS_UPDATE

callhd, value

unsolicited

Call status made available via nccGetExtendedCallStatus has been updated.

value contains the kind of information that has been received.

This event is generated only if the NCC_REPORT_STATUSINFO bit is set in the NCC.START.eventmask parameter (see NCC service global parameters.)

Extended call status information is not available in all protocols. NCC_CAP_ EXTENDED_CALL_STATUS in the capabilitymask returned by nccQueryCapability indicates if the current protocol supports this event or not.

NCCEVN_HOLD_REJECTED

callhd

nccHoldCall

Request to put call on hold was rejected.

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.

NCCEVN_RETRIEVE_REJECTED

callhd

nccRetrieveCall

Application has attempted to retrieve a call it placed on hold, but the network has not allowed it.

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.

NCCEVN_UNBLOCK_FAILED

linehd, value

nccUnblockCalls

Request to unblock a line failed.