Shared Property ID's

Windows Mobile 6.5
4/8/2010

The following table contains the set of property identifiers shared by IAppointment, IContact, and ITask objects (all PIM item types).

Property ID Type Value String name for queries Description

PIMPR_OID

CEVT_PIM_AUTO_I4

0x1000

OID

Unique PIM item object identifier. Read-only.

For more information, see OID Instead of EntryID.

PIMPR_FOLDERNOTIFICATIONS

CEVT_UI4

0x1001

FolderNotifications

This PIM item's folder notifications. Setting this property to one of the Notification Flags causes a particular message notification to be sent to Outlook Mobile.

PIMPR_FOLDER_CATEGORIES

CEVT_LPWSTR

0x101A

FolderCategories

A comma-separated list of all the categories used in this folder. Read-only.

PIMPR_SOURCE_ID

CEVT_UI4

0x001B

SourceId

This PIM item's Source ID.

Valid values are either a Source ID (a 32-bit number with exactly 1 bit set), or 0, which means that no source provider owns this object. The default value is 0. Not valid for Task objects.

For more information, see Customizing the PIM User Experience by Using Source Providers.

PIMPR_RECENT

CEVT_BOOL

0x101C

Recent

A Boolean value indicating whether this PIM item is in the Recently Viewed list.

PIMPR_CATEGORIES

CEVT_LPWSTR

0x101D

Categories

The categories associated with this PIM item. Maximum length is 255 characters.

PIMPR_BODY_BINARY

CEVT_PIM_STREAM

0x001E

BodyInk

The binary representation of this PIM item's body notes.

PIMPR_BODY_TEXT

CEVT_LPWSTR

0x101F

Body

The text representation of this PIM item's body notes.

PIMPR_DO_NOT_SYNC

CEVT_UI4

0x1010

DoNotSynchronize

A flag that identifies whether ActiveSync should synchronize this PIM item with Outlook and Exchange.

This property allows you to create "Do-not-Sync" PIM items.

Setting this property to 1 identifies the PIM item as one that should not be synchronized, and a value of 0 identifies it as one that should be.

This property is a "Write Once" property, which means that can you set it when you create the PIM item, but after the item has been saved, this property cannot be modified.

The following code example demonstrates how to get a list of all of the categories (PIMPR_FOLDER_CATEGORIES) in a folder.

Bb446087.note(en-us,MSDN.10).gifNote:
To make the following code example easier to read, security checking and error handling are not included. This code example should not be used in a release configuration unless it has been modified to include them.
HRESULT GetFolderCategories(LPWSTR pszCategories, int cchCategories, IPOutlookApp2 *polApp, OlDefaultFolders olFolderType)
{
    HRESULT           hr = E_FAIL;
    IFolder    * pFolder = NULL;
    IItem * pFolderIItem = NULL;
    CEPROPVAL    * pVals = NULL;
    int           cProps = 1;

    CEPROPID rgPropIDs[] = { PIMPR_FOLDER_CATEGORIES };

    HANDLE hHeap = GetProcessHeap();

    // Get the IFolder object (Contacts, Contacts, Tasks).
    hr = polApp->GetDefaultFolder(olFolderType, &pFolder);

    // Get the IItem object representing a IFolder object.
    hr = pFolder->QueryInterface(IID_IItem, (LPVOID*)&pFolderIItem);

    // Get the list of categories.
    hr = pFolderIItem->GetProps(rgPropIDs, CEDB_ALLOWREALLOC, cProps, &pVals, 0, hHeap);

    // Copy the list of categories for use outside of this function.
    hr = StringCchCopy(pszCategories, cchCategories, pVals->val.lpwstr);

Exit:
    // Free resources.
    HeapFree(hHeap, 0, pVals);
    pFolderIItem->Release();
    pFolder->Release();

    return hr;
}

Headerpimstore.h
LibraryPimstore.lib
Windows Embedded CEWindows CE .NET 4.0 and later
Windows MobilePocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

Community Additions

Show: