Shared Property ID's

Article
11/18/2015

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.

Code Example

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

Note

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;
}

Requirements

Header	pimstore.h
Library	Pimstore.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

Share via

Shared Property ID's

Code Example

Requirements

See Also

Reference

Additional resources