ICity (Windows Embedded CE 6.0)

1/6/2010

The ICity interface 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

• IUnknown methods
• IDispatch methods

Remarks

To provide better filtering support, ICity::get_TimezoneIndex returns 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_CLOCKRUNNING because 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_CITYINROM is 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.csv data to the Timezone Index of the Timezones.csv data.
• 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.

Requirements

See Also

Reference

Pocket Outlook Object Model Interfaces

Other Resources

Pocket Outlook Object Model Enumerations