Pocket Outlook Object Model Registry Settings (Compact 7)
3/12/2014
The Pocket Outlook Object Model (POOM) registry settings are used for implementing source management and customization functionality. Source Providers and their associated Source IDs are part of a mechanism that supports per-provider customization of the Personal Information Manager (PIM) experience on Windows Embedded Compact powered device.
A Source Provider is a custom function that customizes the PIM user experience. Typically, a Source Provider has a corresponding associate function that is responsible for synchronizing PIM data with the device. Data synchronized with the device by this associate function is marked with a Source identification tag (Source ID). When Outlook Mobile displays a PIM item, it checks to determine whether the item has a Source ID. If it finds one, it invokes the Source Provider, which customizes the user interface for the PIM item.
You register a Source Provider on a device under the HKEY_LOCAL_MACHINE\System\PIMSources registry key, using the following registry path:
\\HKLM
\System
\PIMSources
\<SourceID>
\Colors
\1
Start by creating a <SourceID> subkey under PIMSources. The subkey name will be your Source ID. Choose a SourceID that follows the sequence 1, 2, 4, etc. (exactly one bit set).
Note
When you register your Source Provider, be sure that you create a Source ID that is not already in use on the device. It is your responsibility to ensure that your registration does not collide with other sources.
The following table lists the constant that denotes the registry path, key, and values you can use to programmatically register your Source Provider.
| Name | Value | Type | Description |
|---|---|---|---|
PIMSRC_REGPATH_COLORS |
L"Colors" L"1" |
REG_SZ REG_DWORD |
A subkey under the SourceID key. Include this subkey if you want your Source Provider to support alternate background colors for Appointments in the Agenda and Day views. To specify the color you want, create an entry under this subkey, and give it the name "1" enumeration). The decimal value you assign to "1" represents the color. For example, a value of 65280 represents the color green, because the hexadecimal equivalent of 65280 is FF00 (Red:0, Green:255, Blue:0). |
When users enter new PIM data on the device, they can select the Source Provider to use.
PIM items with a Source ID value of zero use the default user interface.
As part of your Source Provider uninstall procedure, make sure that all PIM items associated with your Source Provider have their Source IDs changed to zero.
Requirements
Header |
pimstore.h |
Library |
Pimstore.lib |