(Page 13 of 23 in this chapter) Version

nccRejectCall

Description

Rejects an incoming call.

Prototype

DWORD nccRejectCall ( NCC_CALLHD callhd,
unsigned method,
void *rejectparms )
callhd Call handle returned with NCCEVN_SEIZURE_DETECTED.
method Method to be used to reject the call:
NCC_REJECT_PLAY_REORDER
NCC_REJECT_PLAY_BUSY
NCC_REJECT_PLAY_RINGTONE
NCC_REJECT_ USER_AUDIO
rejectparms Pointer to protocol-specific CT Access reject call parameter structure. For a protocol-independent application using default parameters, pass NULL. Also see protocol-specific documentation for details.

Return Values

SUCCESS
CTAERR_INVALID_HANDLE
The call handle is not valid. It may have been released.
CTAERR_INVALID_STATE
Line is not in the appropriate state to invoke this function.
NCCERR_INVALID_CALL_STATE
Call is not in the appropriate state to invoke this function.
NCCERR_NOT_CAPABLE
Returned when NCC_REJECT_USER_AUDIO specified when the protocol in use does not support the media capability. The application can determine whether the protocol supports this capability by examining the NCC_CAP_MEDIA_IN_SETUP bit in the capabilitymask returned by nccQueryCapability.

Events

NCCEVN_REJECTING_CALL
The reject call operation has completed successfully and the call has entered the Rejecting call state.
NCCEVN_CALL_DISCONNECTED
The remote party disconnected.

Details

After receiving an NCCEVN_INCOMING_CALL event, the application must invoke nccAnswerCall, nccAcceptCall, or nccRejectCall.
nccRejectCall causes the protocol to reject the incoming call using the method specified by method. Valid methods are:

method

Description

NCC_REJECT_PLAY_REORDER

Play reorder tone.

NCC_REJECT_PLAY_BUSY

Play busy tone.

NCC_REJECT_PLAY_RINGTONE

Play ring tone.

NCC_REJECT_USER_AUDIO

User will supply audio.¹

¹ This method is valid only if the NCC_CAP_MEDIA_IN_SETUP bit in the capabilitymask returned using nccQueryCapability is set.
When a call is being rejected, the application receives NCCEVN_REJECTING_CALL.
To use the default rejection behavior for the current protocol, set method to 0.
If the remote party disconnects while the application is rejecting the call, the application receives NCCEVN_CALL_DISCONNECTED only. In this case, NCCEVN_REJECTING_CALL is not delivered.

See Also

nccAcceptCall, nccAnswerCall

(Page 13 of 23 in this chapter) Version

tech_support@nmss.com

Copyright © 1999, Natural MicroSystems, Inc. All rights reserved.