ITAddressTranslation interface (tapi3if.h)

The ITAddressTranslation interface provides methods that allow translation of a calling address into a different format. For example, an application may need to translate an address from canonical to dialable prior to making a call.

The most common use of this interface is to obtain the pDestAddress string needed for ITAddress::CreateCall. The addresses to be translated are mainly phone numbers in canonical format.

The ITAddressTranslation interface is exposed on the Address Object. A pointer can be obtained by calling QueryInterface on ITAddress.

For additional information, see Address Translation and Dialable Addresses.

Inheritance

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

Methods

The ITAddressTranslation interface has these methods.

 
ITAddressTranslation::EnumerateCallingCards

The EnumerateCallingCards method enumerates calling cards associated with the address. This method is provided for C and C++ applications. Automation client applications, such as those written in Visual Basic, must use the get_CallingCards method.
ITAddressTranslation::EnumerateLocations

The EnumerateLocations method enumerates the currently available address locations. This method is provided for C and C++ applications. Automation client applications, such as those written in Visual Basic, must use the get_Locations method.
ITAddressTranslation::get_CallingCards

The get_CallingCards method creates a collection of calling cards associated with the address.
ITAddressTranslation::get_Locations

The get_Locations method creates a collection of currently available address locations. This method is provided for Automation client applications, such as those written in Visual Basic. C and C++ applications must use the EnumerateLocations method.
ITAddressTranslation::TranslateAddress

The TranslateAddress method creates the address translation information interface.
ITAddressTranslation::TranslateDialog

The TranslateDialog method displays an application-modal dialog box that allows the user to change the current location of a phone number about to be dialed, adjust location and calling card parameters, and see the effect.

Requirements

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

See also

Address Object

Address Translation

Dialable Addresses

IDispatch

ITAddress

ITAddressTranslationInfo

lineGetTranslateCaps

lineTranslateAddress