To place an outbound call, the application invokes nccPlaceCall. The following information is included with this function:
The address of the remote end of the call to be placed.
The address of the local end of the call being placed. This can be NULL if the protocol allows.
Protocol-specific parameters.
The call handle to assign to the call if it is successfully initialized.
Depending on the protocol, the addresses can be phone number digit strings, IP addresses, or endpoint names. This information can be sent all at once, or, if the protocol supports overlap sending, part of the information can be sent with nccPlaceCall, and more can be sent later using nccSendDigits, when the call reaches the placing call state. For more information, refer to Sending overlapped digits.
Invocation of nccPlaceCall changes the call state to outbound initiated. The call remains in the state until NCCEVN_PLACING_CALL occurs, indicating that the line is seized and glare is resolved.
If the application receives an NCCEVN_CALL_RELEASED event with an NCC_RELEASED_GLARE reason code instead of NCCEVN_PLACING_CALL, the line was seized for an incoming call before glare was resolved and the protocol released the outgoing call. The application immediately abandons outbound call placement and handles the incoming call when the NCCEVN_SEIZURE_DETECTED event for the new call arrives.