• IUnknownmethods
  
  
• IDispatchmethods
  
  

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.

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.