(Page 9 of 33 in this chapter) Version
NCCEVN_CALL_HELD
Description
- (solicited) nccHoldCall or nccAutomaticTransfer was invoked; call is now held.
- (unsolicited) The CPE has placed call on hold.
State Transition
- To Idle line state, from Active line state.
Associated Function
- nccHoldCall, nccAutomaticTransfer, unsolicited
Contains
- callhd Call handle.
Reason Codes
- None.
Details
- This event indicates that a call has been placed on hold, either by the application or by a remote party. When a call is placed on hold, no call state change occurs. However, a call on hold is not considered Active. If there are no active calls on a line (i.e., any calls on the line are either held or disconnected) the line state returns to Idle.
- Call holding is not supported by all protocols. The NCC_CAP_HOLD_CALL indicator in the capabilitymask returned by nccQueryCapability indicates if the current protocol supports this event or not.
- Ordinarily, a call can only be placed on hold in the Connected call state. However, if the NCC_CAP_HOLD_IN_ANY_STATE indicator is set in the capabilitymask for the protocol, the call may be put on hold regardless of the call state. In this case, the held call may change call states while on hold.
- 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.
(Page 9 of 33 in this chapter) Version
tech_support@nmss.com
Copyright © 1999, Natural MicroSystems, Inc. All rights
reserved.