| Platform SDK: TAPI |
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.
IUnknown Methods
IDispatch Methods
| ITLocationInfo methods | Description |
|---|---|
| get_PermanentLocationID | Gets permanent location identifier. |
| get_CountryCode | Gets country code. |
| get_CountryID | Gets identifier for country/region. |
| get_Options | Gets indicator of whether the current location supports pulse or tone dialing. |
| get_PreferredCardID | Gets preferred calling card identifier. |
| get_LocationName | Gets location name. |
| get_CityCode | Gets code for city or area. |
| get_LocalAccessCode | Gets local access code. |
| get_LongDistanceAccessCode | Gets code to access long distance. |
| get_TollPrefixList | Gets toll prefix list. |
| get_CancelCallWaitingCode | Gets the dial digits and modifier characters required to cancel call waiting. |
Windows NT/2000: Requires Windows 2000.
Version: Requires TAPI 3.0 or later.
Header: Declared in Tapi3.h.
Library: Use T3iid.lib.
ITAddressTranslation::EnumerateLocations, ITAddressTranslation::get_Locations, ITAddressTranslation::TranslateAddress, lineGetTranslateCaps, LINELOCATIONENTRY