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
ITAddressTranslation::EnumerateLocations
ITAddressTranslation::TranslateAddress