Platform SDK: MAPI

PR_CONTENT_UNREAD

The PR_CONTENT_UNREAD property contains the number of unread messages in a folder, as computed by the message store.

Quick Info

Header file: MAPITAGS.H
Must be exposed by: Folder objects
May be a column in: Folder contents tables
Must be a column in: Folder hierarchy tables
Identifier: 0x3603
Property type: PT_LONG
Property tag: 0x36030003

Remarks

The PR_CONTENT_UNREAD 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 property. The PR_CONTENT_COUNT property contains the total message count for the folder. PR_CONTENT_COUNT and PR_CONTENT_UNREAD are read-only to clients.

Some client applications display the heading row of a category differently depending on the value of PR_CONTENT_UNREAD. For example, a client can display a category that includes unread messages in bold. PR_CONTENT_UNREAD 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.

See Also

Folder Properties, PR_CONTENT_IDENTIFIER