ITCallNotificationEvent interface (tapi3if.h)

The ITCallNotificationEvent interface contains methods that retrieve the description of call notification events. When the application's implementation of the ITTAPIEventNotification::Event method indicates a TAPI_EVENT equal to TE_CALLNOTIFICATION, the method's pEvent parameter is an IDispatch pointer for the ITCallNotificationEvent interface. The methods of this interface can be used to retrieve information concerning the call notification event that has occurred.

This outgoing interface is registered with the TAPI object to get all information about calls. An application must call the ITTAPI::RegisterCallNotifications method on the TAPI object before registering this interface.

Note  You must call the ITTAPI::put_EventFilter method and set an event filter mask that includes the TE_CALLNOTIFICATION event to enable reception of call notification events. If you do not call ITTAPI::put_EventFilter, your application will not receive any events. For more information, see the Events overview.

 

Inheritance

The ITCallNotificationEvent interface inherits from the IDispatch interface. ITCallNotificationEvent also has these types of members:

Methods

The ITCallNotificationEvent interface has these methods.

ITCallNotificationEvent::get_Call The get_Call method returns the ITCallInfo interface on which a call event has occurred.
ITCallNotificationEvent::get_CallbackInstance The get_CallbackInstance method gets a pointer to the callback instance associated with this event. (ITCallNotificationEvent.get_CallbackInstance)
ITCallNotificationEvent::get_Event The get_Event method returns a CALL_NOTIFICATION_EVENT description of whether the application owns or is monitoring the call on which the event has occurred.

Requirements

Requirement	Value
Target Platform	Windows
Header	tapi3if.h (include Tapi3.h)

See also

Call Object

IDispatch

ITTAPI::RegisterCallNotifications

ITTAPIEventNotification::Event

Register Events code snippet

TAPI_EVENT