(Page 10 of 23 in this chapter) Version

nccHoldCall

If the NCC_CAP_HOLD_IN_ANY_STATE bit is set in the capabilitymask returned by nccQueryCapability, depending upon what state the call is in, you may receive other events that are valid in that state. Refer to the event/call state chart in Section 2.6.4 for details.

This function puts a call on hold. There is no call state transition. A call on hold is no longer active. Since there are no active calls currently on the line, the line state changes to idle.
The call is on hold only after the application receives an NCCEVN_CALL_HELD event. The held field in the NCC_CALL_STATUS structure is set to a non-zero value.
Use nccRetrieveCall to unhold a call.
Some protocols do not support the capability to put a call on hold. The application can determine if the protocol supports call hold/retrieve by examining the NCC_CAP_HOLD_CALL bit in the capabilitymask returned by nccQueryCapability.
Some protocols allow a call to be put on hold only from the connected state. The application can determine whether or not a call can be put on hold from any state by examining the NCC_CAP_HOLD_IN_ANY_STATE bit in the capabilitymask returned by nccQueryCapability.
The application may perform media functions on a held call (for example, play user voice file, play silence) using a CT Access media service.