Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The ICityinterface represents a city in the Cities folder. Most of the cities used by the World Clock are provided in ROM and cannot be deleted.

Methods in Vtable Order

ICity methods Description

ICity::get_Longitude

Gets the longitude for the city.

ICity::get_Latitude

Gets the latitude for the city.

ICity::get_TimezoneIndex

Gets the time zone index for the city.

ICity::get_AirportCode

Gets the airport code for the city.

ICity::get_CountryPhoneCode

Gets the telephone country/region code for the city.

ICity::get_AreaCode

Gets the area or city code for the city.

ICity::get_Name

Gets the name of the city.

ICity::get_Country

Gets the country/region for the city.

ICity::get_InROM

Gets a Boolean value indicating whether the city is stored in ROM.

ICity::put_Longitude

Sets the longitude for the city.

ICity::put_Latitude

Sets the latitude for the city.

ICity::put_TimezoneIndex

Sets the time zone index for the city.

ICity::put_AirportCode

Sets the airport code for the city.

ICity::put_CountryPhoneCode

Sets the telephone country/region code for the city.

ICity::put_AreaCode

Sets the area or city code for the city.

ICity::put_Name

Sets the name of the city.

ICity::put_Country

Sets the country/region for the city.

ICity::Save

Saves a city item.

ICity::Delete

Deletes a city item.

ICity::Copy

Copies a city item.

ICity::get_Application

Gets the main Outlook Mobile IPOutlookAppobject.

Remarks

To provide better filtering support, ICity::get_TimezoneIndexreturns a one-based time zone index rather than a time zone object. To get a time zone object, call IPOutlookApp::GetTimeZoneFromIndex.

You can add or remove cities stored in RAM. Additionally, in POOM version 1.1 and later, you can change the properties for any city whether it is stored in RAM or ROM. If you attempt to change or save a city while the World Clock is running, you get the error code E_CLOCKRUNNINGbecause the World Clock program does not accept changes to the cities while it is running.

If you are running a version of Outlook Mobile earlier than 1.1 and you try to save changes to properties of a city stored in ROM, the error code E_CITYINROMis returned.

When you create a city, it must meet the conditions listed in the following table. Otherwise, the city will not be saved successfully. Any attempt to set an illegal value for a city fails.

Property Condition

Longitude

Between -18000 and 18000.

Latitude

Between -9000 and 9000.

Time zone index

Correspond to a valid time zone.

String values

Less than 256 characters in length.

Name

Must be set.

Country

Must be set.

The following information applies to City List Data:

  • To use the data, relate the Timezone Index from the Citylist.csvdata to the Timezone Index of the Timezones.csvdata.

  • If you use the city data provided or if you use any type of geographical information from any source, you are encouraged to provide a way for users to edit, add, and delete information.

This interface is supported for Pocket PC 2000 only. All ICitymethods return E_NOTIMPLfor Windows Mobile Professional, Windows Mobile Classic, and Smartphone 2002 software and later. See Remarksfor information on how to use the City List data for Windows Mobile Professional, Windows Mobile Classic, and Smartphone 2002 software and later.

The following information applies to City List Data:

  • Windows Mobile Professional, Windows Mobile Classic, and Smartphone 2002 software and later cannot programmatically access the City List data that is available through the ICityinterface. To assist developers who need this data for their applications, two files are provided in the \Resource folder of the Pocket PC for Windows Mobile 2003 SDK:

    • Citylist.csvcontains City Name, Country/Region, Longitude and Latitude, Nearest Airport Code, Telephone Dialing Prefix, Telephone Area Code, and the Timezone Index for various cities.

    • Timezones.csvcontains the Timezone Index, GMT Differential, and Description for each time zone.

    • You can use these files in your application on Windows Mobile devices. You can add or remove content to these files. You can redistribute these files as is or repackage this data by including it in source code, a database, or another format. Microsoft bears no responsibility for the content or usage of these files. Certain locales have specific legal requirements with regard to providing data of this type; ensure you are in compliance with such regulations. You cannot use these data files on any platform other than Windows Mobile platforms. You are permitted to use excerpts of this data rather than the entire data set.

Requirements

Header pimstore.h
Library Pimstore.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also