Shared Property ID's

Article
08/28/2006

The following table contains the set of property identifiers shared by Appointment, Contact, Meeting, and Task 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.
PIMPR_FOLDERNOTIFICATIONS	CEVT_UI4	0x1001		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	Source ID	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.
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	Binary representation of the body field	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.

Code Example

The following code example demonstrates how to get a list of all of the categories (PIMPR_FOLDER_CATEGORIES) in a folder, through the Pocket Outlook Object Model.

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;
    CEPROPID rgPropIDs[] = { PIMPR_FOLDER_CATEGORIES };
    int cProps           = 1;
    CEPROPVAL* pVals     = NULL;
    HANDLE hHeap         = GetProcessHeap();

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

    if(FAILED(hr) || NULL == pFolder)
    {
        goto Exit;
    }

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

    if(FAILED(hr) || NULL == pFolderIItem)
    {
        goto Exit;
    }

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

    if(FAILED(hr) || NULL == pVals || NULL == pVals->val.lpwstr)
    {
        goto Exit;
    }

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

    if(FAILED(hr))
    {
        goto Exit;
    }

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

    return hr;

}

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

Shared Property ID's

Code Example

Requirements

See Also

Additional resources