ITTAPI interface (tapi3if.h)

The ITTAPI interface is the base interface for the TAPI object. The TAPI object is created by CoCreateInstance. For information on CoCreateInstance, see documentation on COM. All other TAPI 3 objects are created by TAPI 3 itself.

ITTAPI methods are provided to initialize a TAPI session, enumerate available addresses, register for CallHub and CallEvent notifications, and shut down a TAPI session.

The ITTAPI2 interface derives from the ITTAPI interface. It adds additional methods on the TAPI object to support phone devices.

Inheritance

The ITTAPI interface inherits from the IDispatch interface. ITTAPI also has these types of members:

Methods

The ITTAPI interface has these methods.

 
ITTAPI::EnumerateAddresses

The EnumerateAddresses method enumerates the addresses that are currently available. Provided for C and C++ applications. Automation client applications, such as those written in Visual Basic, must use the get_Addresses method.
ITTAPI::EnumerateCallHubs

The EnumerateCallHubs method enumerates the currently available call hubs. Provided for C and C++ applications. Automation client applications, such as those written in Visual Basic, must use the get_Callhubs method.
ITTAPI::EnumeratePrivateTAPIObjects

The EnumeratePrivateTAPIObjects method of the ITTAPI interface is not implemented and will return E_NOTIMPL.
ITTAPI::get_Addresses

The get_Addresses method creates a collection of addresses that are currently available. Provided for Automation client applications, such as those written in Visual Basic. C and C++ applications must use the EnumerateAddresses method.
ITTAPI::get_CallHubs

The get_CallHubs method creates a collection of the currently available call hubs. Provided for Automation client applications, such as those written in Visual Basic. C and C++ applications must use the EnumerateCallHubs method.
ITTAPI::get_EventFilter

The get_EventFilter method gets the current event filter mask. The mask is a series of ORed members of the TAPI_EVENT enumeration.
ITTAPI::get_PrivateTAPIObjects

The get_PrivateTAPIObjects method of the ITTAPI interface is not implemented and will return E_NOTIMPL.
ITTAPI::Initialize

The Initialize method initializes TAPI. This method must be called before calling any other TAPI 3 method. The application must call the Shutdown method when ending a TAPI session.
ITTAPI::put_EventFilter

The put_EventFilter method sets the event filter mask. The mask is a series of ORed members of the TAPI_EVENT enumeration.
ITTAPI::RegisterCallNotifications

The RegisterCallNotifications method sets which new call notifications an application will receive. The application must call the method for each address, indicating media type or types it can handle, and specifying the privileges it requests.
ITTAPI::RegisterRequestRecipient

The RegisterRequestRecipient method registers an application instance as being the proper one to handle assisted telephony requests.
ITTAPI::SetApplicationPriority

The SetApplicationPriority method allows an application to set its priority in the handoff priority list for a particular media type or Assisted Telephony request mode, or to remove itself from the priority list.
ITTAPI::SetAssistedTelephonyPriority

The SetAssistedTelephonyPriority method sets the application priority to handle assisted telephony requests.
ITTAPI::SetCallHubTracking

The SetCallHubTracking method enables or disables CallHub tracking.
ITTAPI::Shutdown

The Shutdown method shuts down a TAPI session.
ITTAPI::UnregisterNotifications

The UnregisterNotifications method removes any incoming call notification registrations that have been performed using ITTAPI::RegisterCallNotifications.

Requirements

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

See also

IDispatch

ITTAPI2

TAPI Object