To reject a call, an application invokes nccRejectCall. With most protocols, the application can also specify a method to be used to reject the call. The following list describes the valid methods:
|
Method |
Description |
|---|---|
|
NCC_REJECT_PLAY_RINGTONE |
Play a ring tone until the remote party disconnects. |
|
NCC_REJECT_PLAY_BUSY |
Send a backward tone or signal to indicate that the call is busy. |
|
NCC_REJECT_PLAY_REORDER |
Send a reorder tone. Reorder usually means that the number is incorrectly formatted, or is not allocated. |
|
NCC_REJECT_USER_AUDIO |
The application generates a recorded message, or a special information tone. If the remote party hangs up, the protocol interrupts the application tone or voice file. |
When nccRejectCall is invoked, the application receives NCCEVN_REJECTING_CALL. The call is now in the rejecting call state. The call remains in this state while the NCC API attempts to reject the call. Subsequent receipt of NCCEVN_CALL_DISCONNECTED indicates that the call rejection was successful. The application now invokes nccReleaseCall to release the call.
If the remote party disconnects while the application rejects the call, the application receives an NCCEVN_CALL_DISCONNECTED event. In this case, NCCEVN_REJECTING_CALL is not delivered.