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