Shared Property ID's
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
See Also
Pocket Outlook Object Model API Property Identifiers | IAppointment | IContact | ITask
Send Feedback on this topic to the authors