| Platform SDK: TAPI |
The ITCallInfoChangeEvent interface contains methods that retrieve the description of call information change events. When the application's implementation of the ITTAPIEventNotification::Event method indicates a TAPI_EVENT equal to TE_CALLINFOCHANGE, the method's pEvent parameter is an IDispatch pointer for the ITCallInfoChangeEvent interface. The methods of this interface can be used to retrieve information concerning the call information that has changed.
The ITCallInfoChangeEvent is an outgoing interface. This interface is registered with the TAPI object to get all information about calls. An application must have called the ITTAPI::RegisterCallNotifications method on the TAPI object before registering this interface. If not, the call to Advise will fail. This interface cannot be unregistered — Unadvise will always fail.
Note You must call the ITTAPI::put_EventFilter method and set an event filter mask that includes the TE_CALLINFOCHANGE event to enable reception of call information change events. If you do not call ITTAPI::put_EventFilter, your application will not receive any events. For more information, see the Events overview.
IUnknown Methods
IDispatch Methods
| ITCallInfoChangeEvent methods | Description |
|---|---|
| get_Call | Gets a pointer to the ITCallInfo interface. |
| get_Cause | Gets a CALLINFOCHANGE_CAUSE descriptor of the change. |
| get_CallbackInstance | Gets the callback instance associated with the event. |
Windows NT/2000: Requires Windows 2000.
Version: Requires TAPI 3.0 or later.
Header: Declared in Tapi3.h.
Library: Use T3iid.lib.