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

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 IPOutlookApp object.

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.

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.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

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

See Also

Reference

Pocket Outlook Object Model Interfaces

Other Resources

Pocket Outlook Object Model Enumerations