ICity::Unknown
This interface is not supported in Windows CE Platform Builder 3.0.
Represents a City in the Cities folder. Most of the cities used by the World Clock are provided in ROM and cannot be deleted.
Note Cities return a one-based time zone index rather than a TimeZone object. This is to provide better filtering support. To get a TimeZone object, call GetTimeZone object on the Pocket Outlook Application object.
Methods in Vtable Order
| Method | Description |
|---|---|
| ICity::Save | Saves a city. |
| ICity::Delete | Deletes a city. |
| ICity ::Copy | Duplicates a city. |
| ICity ::Display | Displays a city. |
Valid Cities
When you create a city you must meet the following requirements:
- Longitude must be between -18000 and positive 18000.
- Latitude must be between -9000 and positive 9000.
- TimezoneIndex must correspond to a valid time zone.
- String values must not exceed 256 characters in length.
- Name and Country properties must be set.
It a city does not fulfill these requirements, it will not be saved successfully. Any attempt to set an illegal value for a city will fail.
Remarks
You can add or remove cities stored in RAM. Additionally, in Pocket Outlook 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. This is because the World Clock program does not accept changes to the cities while it is running.
If you are running a version of Pocket Outlook earlier than 1.1 and you try to save changes to properties of a city stored in ROM, Windows CE returns E_CITYINROM.
Requirements
| Runs On | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 2.0 and later | pimstore.h |
See Also
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.