Table of Contents Index NMS Glossary Previous Page Next Page (Page 30 of 69 in this chapter) Version


adiRejectCall

Description

Rejects an incoming call.

Note: This function and all other ADI call control functions have been superseded by the NCC service. For more information, see the Natural Call Control Service Developer's Reference Manual.

Prototype

DWORD adiRejectCall ( CTAHD ctahd,
unsigned method )

ctahd CTA context handle returned by ctaCreateContext.

method Specifies the trunk protocol action for rejecting the call.

Return Values

Events

Details

After receiving an ADIEVN_INCOMING_CALL event, the application must invoke either adiAnswerCall or adiRejectCall.

adiRejectCall causes the trunk protocol to reject the incoming call and, depending upon the method argument, perform one of the following actions:
Method

Description

ADI_REJ_PLAY_REORDER

Play reorder (fast busy) tone.

ADI_REJ_PLAY_BUSY

Play busy tone.

ADI_REJ_PLAY_RINGTONE

Play ring tone.

ADI_REJ_USER_AUDIO

Allows the application to generate any programmable tone and perform voice playback functions.

ADI_REJ_FORCE_IMMEDIATE

In AG ISDN, causes the TCP to actively clear a rejected call by sending a RELEASE message. If this method is not used, the TCP clears a call by sending a PROGRESS message to the network, which opens the audio path, and then plays a busy signal.

The generated reject tone is played until the remote party disconnects.

If the method is ADI_REJ_USER_AUDIO, then the application can generate any programmable tone and perform voice playback functions. For example, you could generate an SIT (Special Information Tone) message. The application must wait for the ADIEVN_REJECTING_CALL event before generating an SIT.

If the remote party disconnects while the application rejects the call, the ADI service will only generate an ADIEVN_CALL_DISCONNECTED event. In this case, no ADIEVN_REJECTING_CALL event is delivered.

Some protocols allow you to use adiSetExtendedArgs to set additional arguments to adiRejectCall. For more information about controlling calls under specific TCPs, refer to the AG CAS for ADI Service Installation and Developer's Manual.

Note: This function is not available when using the NOCC protocol.

See Also

adiAnswerCall, adiPlaceCall, adiReleaseCall, adiSetExtendedArgs

Example

Refer to the adiAcceptCall example.



Table of Contents Index NMS Glossary Previous Page Next Page (Page 30 of 69 in this chapter) Version


Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2000, Natural MicroSystems, Inc. All rights reserved.