(Page 10 of 15 in this chapter) Version

briRejectCall

Description

Rejects an incoming call.

Prototype

DWORD briRejectCall ( CTAHD ctahd,
unsigned method )
ctahd CTA context handle returned by ctaCreateContext.
method Must be BRI_REJ_FORCE_IMMEDIATE.

Return Values

SUCCESS
BRIERR_INVALID_CALL_STATE
CTAERR_BAD_ARGUMENTInvalid method.
CTAERR_DRIVER_SEND_FAILED
CTAERR_INVALID_CTAHD
CTAERR_INVALID_STATE

Events

BRIEVN_CALL_DISCONNECTEDGenerated after the call has been rejected.
BRIEVN_REJECTING_CALL
Generated by the BRI service after the rejection is initiated.
BRIEVN_STATUS_UPDATEGenerated when some asynchronous information regarding the call (UUI information) has arrived. The event value field contains the information type.

Details

After receiving a BRIEVN_INCOMING_CALL event, the application must invoke either briAcceptCall, briAnswerCall or briRejectCall.
briRejectCall causes the ISDN stack to reject the incoming call immediately. Depending upon the network switch, the remote party may or may not receive a tone specifying the call rejection.
When accepting and then rejecting a call, the remote party may first receive a ring back tone (when the call is accepted) and then a busy tone (when it is rejected).
Refer to Chapter 4 for a detailed explanation of call control.

See Also

briAcceptCall, briAnswerCall, briPlaceCall, briReleaseCall

Example

Refer to the briPlaceCall example.

(Page 10 of 15 in this chapter) Version

tech_support@nmss.com

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