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
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | tapi3if.h (include Tapi3.h) |