Platform SDK: TAPI

ITAddressTranslation

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.

Methods in Vtable Order

IUnknown Methods

IDispatch Methods

ITAddressTranslation methods Description
TranslateAddress Creates the address translation information interface.
TranslateDialog Invokes the control panel's telephony applet.
EnumerateLocations Enumerates the currently available address locations.
get_Locations Creates a collection of currently available address locations. This method is provided for Automation client applications, such as those written in Visual Basic.
EnumerateCallingCards Enumerates calling cards associated with the address.
get_CallingCards Creates a collection of calling cards associated with the address. This method is provided for Automation client applications, such as those written in Visual Basic.

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

Address Object, ITAddress, ITAddressTranslationInfo, Address Translation, Dialable Addresses, lineTranslateAddress, lineGetTranslateCaps