ITAddressEvent interface (tapi3if.h)

The ITAddressEvent interface contains methods that retrieve the description of address events. When the application's implementation of the ITTAPIEventNotification::Event method indicates a TAPI_EVENT equal to TE_ADDRESS, the method's pEvent parameter is an IDispatch pointer for the ITAddressEvent interface. The methods of this interface can be used to retrieve information concerning the type of event, which address the event has occurred on, and for which terminal.

Note  You must call the ITTAPI::put_EventFilter method and set an event filter mask that includes the TE_ADDRESS event to enable reception of address 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 ITAddressEvent interface inherits from the IDispatch interface. ITAddressEvent also has these types of members:

Methods

The ITAddressEvent interface has these methods.

ITAddressEvent::get_Address The get_Address method gets a pointer to the ITAddress object involved in an event.
ITAddressEvent::get_Event The get_Event method gets the ADDRESS_EVENT descriptor of an event.
ITAddressEvent::get_Terminal The get_Terminal method gets a pointer to the ITTerminal interface associated with the event.

Remarks

Certain events on PnP devices will not be received until after the first time static terminals are enumerated using ITTerminalSupport::EnumerateStaticTerminals or ITTerminalSupport::get_StaticTerminals.

Requirements

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

See also

ADDRESS_EVENT

Address Object

Device Events overview

Event Notification overview

IDispatch

ITAddress

ITTAPIEventNotification::Event

ITTerminal

Register Events code snippet

TAPI_EVENT