PidTagContentUnreadCount Canonical Property
Applies to: Office 2010 | Outlook 2010 | Visual Studio
Contains the number of unread messages in a folder, as computed by the message store.
Associated properties: |
PR_CONTENT_UNREAD |
Identifier: |
0x3603 |
Data type: |
PT_LONG |
Area: |
Folder |
Remarks
This property computed by the message store is used for two different, though related, purposes. On a MAPI folder object, it contains the number of messages in a folder. In a heading row in categorized MAPI tables, it contains the number of unread non-associated messages in the category corresponding to that heading row.
This property contains the number of messages in the folder contents table for which the MSGFLAG_READ flag is not set in the PR_MESSAGE_FLAGS (PidTagMessageFlags) property. The PR_CONTENT_COUNT (PidTagContentCount) property contains the total message count for the folder. The PR_CONTENT_COUNT and this property are read-only to clients.
Some client applications display the heading row of a category differently depending on the value of this property. For example, a client can display a category that includes unread messages in bold. This property cannot be used as a category and an attempt to do so results in the MAPI_E_INVALID_PARAMETER value being returned from the IMAPITable::SortTable method.
Related Resources
Protocol Specifications
[MS-OXPROPS]
Provides references to related Microsoft Exchange Server protocol specifications.[MS-OXCFOLD]
Handles folder operations.[MS-OXCTABL]
Includes permissible operations for the core table objects.
Header Files
Mapidefs.h
Provides data type definitions.Mapitags.h
Contains definitions of properties listed as alternate names.