Platform SDK: TAPI

ITRequestEvent

The ITRequestEvent interface contains methods that allow an application to receive and process Assisted Telephony request events. When the application's implementation of the ITTAPIEventNotification::Event method indicates a TAPI_EVENT equal to TE_REQUEST, the method's pEvent parameter is an IDispatch pointer for the ITRequestEvent interface. The methods of this interface can be used to retrieve information concerning a request event that has occurred.

Note  You must call the ITTAPI::put_EventFilter method and set an event filter mask that includes the TE_REQUEST event to enable reception of request 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

ITRequestEvent methods Description
get_RegistrationInstance Gets the registration instance.
get_RequestMode Gets the request mode descriptor.
get_DestAddress Gets the destination address.
get_AppName Gets the name of the application.
get_CalledParty Gets the called party.
get_Comment Gets a comment associated with the request 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, ITRequest