request a connection to make an outgoing call cc_MakeCall( )
171
Parameter Description
linedev:
The line device handle or, for applications using the call
waiting feature, the board device handle (BRI and Windows
only).
crnp:
Pointer to the buffer where the call reference number will be
stored.
numberstr:
The destination (called party 's) telephone number string. The
maximum length is 32 digits.
makecallp:
The pointer to the MAKECALL_BLK structure, which is a list
of parameters used to specify the outgoing call. See Section
6.8. MAKECALL_BLK for a description of the
MAKECALL_BLK structure and for definitions and possible
values for the parameters contained in the structure. For
information on initializing the MAKECALL_BLK structure,
see Section 6.8.1. MAKECALL_BLK Initialization.
timeout:
The amount of time (in seconds) during which the call must be
established. (Used in synchronous mode only.) If the timeout
value expires before the remote end answers the call, then the
cc_MakeCall( ) function returns -1. Setting the timeout
parameter to 0 causes this parameter to be ignored.
mode:
Specifies asynchronous (EV_ASYNC) or synchronous
(EV_SYNC) mode.
!
! !
!
Termination Events
• CCEV_CONNECTED - indicates that a CONNECT message has been
received by the network.
• CCEV_TASKFAIL - indicates that a request/message was rejected by the
firmware. Typically, this event is triggered by an incorrect function call
during the call.
!
! !
!
Cautions
• Every field of the MAKECALL_BLK structure must be filled. Use the value
ISDN_NOT_USED if the field does not apply to the specific ISDN
provisioning or service. If a string field is not used, set the field to NULL.