Source Provider PIM Type Ownership Flags

Send Feedback

These flags describe the types of PIM items that are associated with a particular Source Provider.

Option Value Description
PIMSRC_TYPE_CONTACTS 0x00000001 Source Provider defines a custom display card for Contacts.
PIMSRC_TYPE_APPOINTMENTS 0x00000002 Source Provider changes the background color for Appointments in the Agenda and Day views.
PIMSRC_TYPE_TASKS 0x00000004 Not supported.
PIMSRC_TYPE_VALIDMASK 0x00000003 Source Provider defines a custom display card for Contacts, and changes the background color for Appointments in the Agenda and Day views.

(PIMSRC_TYPE_CONTACTS | PIMSRC_TYPE_APPOINTMENTS)

Remarks

Source Providers and their associated Source ID's are part of a mechanism that supports per-provider customization of the PIM experience on Windows Mobile–based devices.

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 Windows Mobile–based device. Data synchronized with the Windows Mobile–based device by this associate function is marked with a Source identification tag (Source ID). When Outlook Mobile displays a PIM item, it checks to see if the item has a Source ID. If it finds one, it invokes the Source Provider, which customizes the user interface for the PIM item.

When users enter new contacts and appointments, they can select a Source Provider to associate with them.

A valid Source ID is a DWORD with only 1 bit set (i.e., there are 32 possible Source IDs).

Although Contact and Appointment items, regardless of Source ID, are synchronized with Microsoft Exchange — Source IDs are not.

Source IDs are not supported for Task items.

Since Contacts and Appointments can be associated with only one Source Provider, your Source Provider installation implementation must select a Source ID that is unique in the domain of all Source Providers installed on the Windows Mobile–based device (it is considered an error to determine Source IDs prior to install). Your implementation must choose a unique Source ID by first iterating over the installed Source Providers registered in the key \HKLM\PIMSources\, and then choosing the next available Source ID.

The default Source ID value is zero (0). Contact and Appointment items with a Source ID value of zero are not associated with a Source Provider, and just use the default user interface.

Your Source Provider uninstall implementation must reset the Source ID field of all associated Contact and Appointment items back to zero.

Requirements

Pocket PC: Windows Mobile Version 5.0 and later
Smartphone: Windows Mobile Version 5.0 and later
OS Versions: Windows CE 5.01 and later
Header: pimstore.h
Library: pimstore.lib

See Also

Pocket Outlook Object Model API Flags | Register a Source Provider | IPimSrcContactListIcon::Paint | IPimSrcContactSummaryCard::Display

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.