ITLocationInfo interface (tapi3if.h)

The ITLocationInfo interface is used to get information related to the location of the calling party. This is the location information that is entered by using the Telephony applet under the Control Panel.

An ITLocationInfo interface pointer is obtained by using ITAddressTranslation::EnumerateLocations or ITAddressTranslation::get_Locations. There can be more than one location entries in the Telephony applet. If so, EnumerateLocations and get_Locations will return them all. However, only one of them is the current location, and TAPI uses that one as the address translation context when ITAddressTranslation::TranslateAddress is called.

The ITLocationInfo interface is a COM wrapper for the TAPI 2.x LINELOCATIONENTRY structure.

Inheritance

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

Methods

The ITLocationInfo interface has these methods.

 
ITLocationInfo::get_CancelCallWaitingCode

The get_CancelCallWaitingCode method gets the dial digits and modifier characters that must be prefixed to a dialable string to cancel call waiting.
ITLocationInfo::get_CityCode

The get_CityCode method gets the code for the city.
ITLocationInfo::get_CountryCode

The get_CountryCode method gets the country/region code.
ITLocationInfo::get_CountryID

The get_CountryID method gets the identifier for the country/region.
ITLocationInfo::get_LocalAccessCode

The get_LocalAccessCode method gets the local access code.
ITLocationInfo::get_LocationName

The get_LocationName method gets the location name.
ITLocationInfo::get_LongDistanceAccessCode

The get_LongDistanceAccessCode method gets the code to access long distance.
ITLocationInfo::get_Options

The get_Options method gets an indicator of whether the current location supports pulse or tone dialing.
ITLocationInfo::get_PermanentLocationID

The get_PermanentLocationID method gets the permanent location identifier.
ITLocationInfo::get_PreferredCardID

The get_PreferredCardID method gets the preferred calling card identifier for dialing from the current location.
ITLocationInfo::get_TollPrefixList

The get_TollPrefixList method gets the toll prefix list.

Requirements

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

See also

IDispatch

ITAddressTranslation::EnumerateLocations

ITAddressTranslation::TranslateAddress

ITAddressTranslation::get_Locations

LINELOCATIONENTRY

lineGetTranslateCaps