Filter
Top Products
cc_RetrieveRej( ) reject a request to retrieve a held call
210
Name:
int cc_RetrieveRej(crn, cause)
Inputs:
CRN crn
• call reference number
int cause
• standard ISDN Network cause/error
code
Returns:
0 on success
<0 on failure
Includes:
cclib.h
Category:
Hold and Retrieve
Mode:
synchronous
Technology:
BRI/2; BRI/SC; PRI (Q.SIG only)
!
! !
!
Description
The cc_RetrieveRej( ) function allows the application to reject a request to
retrieve a held call from remote equipment. The call must be in Hold state and the
CCEV_RETRIEVECALL event must be received before this function is called.
Parameter Description
crn:
The call reference number. Each call needs a CRN.
cause:
A standard ISDN Network cause/error code is returned
indicating the reason the hold request was rejected. Possible
causes include TEMPORARY_FAILURE (Cause 41),
NETWORK_OUT_OF_ORDER (Cause 38), and
NETWORK_CONGESTION (Cause 42). For a complete list
of ISDN Network cause/error codes, see Section
7.2.2. Cause/Error Codes from the ISDN Network.
!
! !
!
Cautions
• The cc_RetrieveRej( ) function can only be used after the call is in Hold
state and after the CCEV_RETRIEVECALL event is received.
• The BRI protocols and the PRI Q.SIG protocol are the only protocols that
allow the rejection of the retrieval of a call in the Hold state. The
cc_RetrieveRej( ) function cannot be used in the PRI DPNSS protocol. If
used in unsupported protocols, the cc_RetrieveRej( ) function call will pass
but the retrieve from Hold request will not be rejected and the call will no
longer be in the Hold state.