Platform SDK: TAPI

ITTAPIObjectEvent

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.

Methods in Vtable Order

IUnknown Methods

IDispatch Methods

ITTAPIObjectEvent methods Description
get_TAPIObject Gets a pointer to the ITTAPI object on which the event occurred.
get_Event Gets the TAPI_EVENT descriptor of an asynchronous event notification.
get_Address Gets a pointer to the ITAddress interface.
get_CallbackInstance Get the callback instance associated with the event.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

ITTAPIEventNotification::Event, TAPI_EVENT, TAPI Object