ITTAPIObjectEvent interface (tapi3if.h)

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

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

 

The ITTAPIObjectEvent2 interface is an extension of the ITTAPIObjectEvent interface. ITTAPIObjectEvent2 exposes an additional method that returns a pointer to an ITPhone interface on the phone object that caused the TAPI object event.

Inheritance

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

Methods

The ITTAPIObjectEvent interface has these methods.

ITTAPIObjectEvent::get_Address The get_Address method gets a pointer to the Address object on which the event occurred.
ITTAPIObjectEvent::get_CallbackInstance The get_CallbackInstance method gets a pointer to the callback instance associated with the event. (ITTAPIObjectEvent.get_CallbackInstance)
ITTAPIObjectEvent::get_Event The get_Event method gets information concerning an asynchronous event notification. The application uses TAPIOBJECT_EVENT to determine what type of event is being signaled.
ITTAPIObjectEvent::get_TAPIObject The get_TAPIObject method gets a pointer to the TAPI object on which the event occurred.

Requirements

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

See also

IDispatch

ITTAPIEventNotification::Event

ITTAPIObjectEvent2

Register Events code snippet

TAPI Object

TAPI_EVENT