PidTagContentUnreadCount Canonical Property

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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 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.

Protocol Specifications

  • [MS-OXPROPS]
    Provides references to related 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.

See Also

Concepts

MAPI Properties

MAPI Canonical Properties

Mapping Canonical Property Names to MAPI Names

Mapping MAPI Names to Canonical Property Names