TEXT, NATIVE LANGUAGE SUPPORT, AND TIME MEDIA

Calls

A call represents an ongoing telephone connection, which progresses through a series of conditions or states. In many cases, a single line can support multiple, simultaneous calls--for example, one call might be on hold while another is active, or a call might be added to an existing connection for a conference call.

Call handles

You access information about a call through a TTelephoneCallHandle created by the TTelephoneLine:

Call status

The Telephony system allows the computer to monitor the progress of a call. In the real world, call status feedback is communicated audibly; for example, a continuous tone indicates that a call can be placed, and an interrupted tone indicates that the destination line is busy. In the Telephony system, the call status constants represent all of the states indicated by the familiar audible tones, as well as more detailed information. You can monitor the call status in two ways:

Call TTelephoneCallHandle::GetStatus.
Create a call notification interest by calling TTelephoneLineHandle::CreateCallNotificationInterest and set up a notification connection.

Call status Description

kCallIdle The call is inactive (default state).

kIncompleteCallInfo The call placement is in progress but more information is needed.

kCallReorder The call placement could not proceed; there was an error in
the number.

kCallCannotComplete The call placement could not be completed.

kReadyToDial A dial tone is present.

kFastBusy The dial tone timed out.

kDialingComplete The dial-out operation was completed successfully.

kRingbackDetected The destination phone is ringing.

kBusyDetected The destination phone number is busy.

kNoAnswer The destination phone number was not answered.

kCallActive The call has been successfully connected.

kCallOnHold The call has been put on hold.

kCallTerminationDetected The network or the connected party has terminated the call.

[Contents] [Previous] [Next]

Click the icon to mail questions or corrections about this material to Taligent personnel.

Generated with WebMaker

	Call status	Description
	kCallIdle	The call is inactive (default state).
	kIncompleteCallInfo	The call placement is in progress but more information is needed.
	kCallReorder	The call placement could not proceed; there was an error in the number.
	kCallCannotComplete	The call placement could not be completed.
	kReadyToDial	A dial tone is present.
	kFastBusy	The dial tone timed out.
	kDialingComplete	The dial-out operation was completed successfully.
	kRingbackDetected	The destination phone is ringing.
	kBusyDetected	The destination phone number is busy.
	kNoAnswer	The destination phone number was not answered.
	kCallActive	The call has been successfully connected.
	kCallOnHold	The call has been put on hold.
	kCallTerminationDetected	The network or the connected party has terminated the call.