PR_STORE_SUPPORT_MASK
The PR_STORE_SUPPORT_MASK property contains a bitmask of flags that client applications should query to determine the characteristics of a message store.
Quick Info
Header file: |
MAPITAGS.H |
Must be exposed by: |
Folder, message, and message store objects |
Identifier: |
0x3A0D |
Property type: |
PT_LONG |
Property tag: |
0x3A0D0003 |
Remarks
The PR_STORE_SUPPORT_MASK property discloses the capabilities of a message store to client applications planning to send it a message. The flags can facilitate decisions by a client or another store, such as whether to send PR_BODY or only PR_RTF_COMPRESSED. A client should never set PR_STORE_SUPPORT_MASK; an attempt returns MAPI_E_COMPUTED.
One or more of the following flags can be set for the PR_STORE_SUPPORT_MASK bitmask:
-
STORE_ATTACH_OK
-
The message store supports attachments (OLE or non-OLE) to messages.
-
STORE_CATEGORIZE_OK
-
The message store supports categorized views of tables.
-
STORE_CREATE_OK
-
The message store supports creation of new messages.
-
STORE_ENTRYID_UNIQUE
-
Entry identifiers for the objects in the message store are unique, that is, never reused during the life of the store.
-
STORE_HTML_OK
-
The message store supports Hypertext Markup Language (HTML) messages, stored in the PR_BODY_HTML property.
-
STORE_MODIFY_OK
-
The message store supports modification of its existing messages.
-
STORE_MV_PROPS_OK
-
The message store supports multivalued properties, guarantees the stability of value order in a multivalued property throughout a save operation, and supports instantiation of multivalued properties in tables.
-
STORE_NOTIFY_OK
-
The message store supports notifications.
-
STORE_OLE_OK
-
The message store supports OLE attachments. The OLE data is accessible through an IStorage interface, such as that available through the PR_ATTACH_DATA_OBJ property.
-
STORE_PUBLIC_FOLDERS
-
The folders in this store are public (multi-user), not private (possibly multi-instance but not multi-user).
-
STORE_READONLY
-
All interfaces for the message store have a read-only access level.
-
STORE_RESTRICTION_OK
-
The message store supports restrictions.
-
STORE_RTF_OK
-
The message store supports Rich Text Format (RTF) messages, usually stored compressed, and the store itself keeps PR_BODY and PR_RTF_COMPRESSED synchronized.
-
STORE_SEARCH_OK
-
The message store supports search-results folders.
-
STORE_SORT_OK
-
The message store supports sorting views of tables.
-
STORE_SUBMIT_OK
-
The message store supports marking a message for submission.
-
STORE_UNCOMPRESSED_RTF
-
The message store supports storage of Rich Text Format (RTF) messages in uncompressed form. An uncompressed RTF stream is identified by the value dwMagicUncompressedRTF in the stream header. The dwMagicUncompressedRTF value is defined in the RTFLIB.H file.
An RTF version of a message can always be stored, even if the message store is non-RTF-aware. If the STORE_RTF_OK bit is not set for a particular store, a client maintaining RTF versions must itself call the RTFSync function to keep the PR_BODY and PR_RTF_COMPRESSED versions synchronized for text content. RTF is always stored in PR_RTF_COMPRESSED, whether it is actually compressed or not.
See Also
Provider Properties