ITCallInfoChangeEvent interface (tapi3if.h)
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.
Inheritance
The ITCallInfoChangeEvent interface inherits from the IDispatch interface. ITCallInfoChangeEvent also has these types of members:
Methods
The ITCallInfoChangeEvent interface has these methods.
| ITCallInfoChangeEvent::get_Call The get_Call method returns the ITCallInfo interface on which call information has changed. |
| ITCallInfoChangeEvent::get_CallbackInstance The get_CallbackInstance method gets a pointer to the callback instance associated with this event. (ITCallInfoChangeEvent.get_CallbackInstance) |
| ITCallInfoChangeEvent::get_Cause The get_Cause method gets a CALLINFOCHANGE_CAUSE description of the change. |
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | tapi3if.h (include Tapi3.h) |
See also
ITTAPI::RegisterCallNotifications