There are three specialized TInterest classes in the Telephony system that you use to request status updates. You create instances of these classes by calling the member functions provided by TTelephoneLineHandle and TTelephoneHandsetHandle.
TTelephoneInterest enables you to request notification of certain telephony events that affect a particular telephone line or handset. These events include changes in hook status, ring indications from incoming calls, and the arrival of remotely generated digit strings.
TTelephoneCallInterest enables you to request notification of changes in the progress of a particular telephone connection.
TTelephoneFeatureInterest enables you to request notification of changes in the progress of a particular instance of a telephone feature.
There are three telephony-oriented classes derived from TNotification. You receive notification from the Telephony system when you request status updates.
TTelephoneStatusNotification transports a status update and contains a TTelephoneInterest, a TTelephoneCallInterest, or a TTelephoneFeatureInterest. Status updates can be assigned one of four values, depending on the progress of the operations with which they are associated. These values allow you to perform a preliminary classification of an incoming notification without explicitly examining the status field. These telephone status values are represented by ETelephoneStatusClassification:
Telephony
interest classes
Telephony
notification classes
| Operation status | Description | |
| kSuccess | The operation completed successfully. | |
| kInProgress | The operation is proceeding normally. | |
| kFailure | The operation was prevented from being completed. | |
| kUnknown | The progress of the operation is unknown for this state. |
TTelephoneRingNotification transports the phone number of an incoming call before it has been answered.
TTelephoneDigitsNotification transports raw DTMF (dual-tone multifrequency) digits from a remotely connected telephone's keypad.
[Contents]
[Previous]
[Next]
Click the icon to mail questions or corrections about this material to Taligent personnel.