Groups of Address Properties

Platform SDK: Exchange Server

Groups of Address Properties

Some properties are stored and linked to each other in groups. This linked storage affects the ways they can be manipulated. The following table lists the MAPI-defined address property groups.

Address Property Groups

Set Name	Set Members
PR_SENDER_*	PR_SENDER_ADDRTYPE PR_SENDER_EMAIL_ADDRESS PR_SENDER_ENTRYID PR_SENDER_NAME PR_SENDER_SEARCH_KEY
PR_SENT_ REPRESENTING_*	PR_SENT_REPRESENTING_ADDRTYPE PR_SENT_REPRESENTING_EMAIL_ADDRESS PR_SENT_REPRESENTING_ENTRYID PR_SENT_REPRESENTING_NAME PR_SENT_REPRESENTING_SEARCH_KEY
PR_ORIGINAL_ SENDER_*	PR_ORIGINAL_SENDER_ADDRTYPE PR_ORIGINAL_SENDER_EMAIL_ADDRESS PR_ORIGINAL_SENDER_ENTRYID PR_ORIGINAL_SENDER_NAME PR_ORIGINAL_SENDER_SEARCH_KEY
PR_ORIGINAL_SENT_ REPRESENTING_*	PR_ORIGINAL_SENT_REPRESENTING_ADDRTYPE PR_ORIGINAL_SENT_REPRESENTING_EMAIL_ADDRESS PR_ORIGINAL_SENT_REPRESENTING_ENTRYID PR_ORIGINAL_SENT_REPRESENTING_NAME PR_ORIGINAL_SENT_REPRESENTING_SEARCH_KEY
PR_RECEIVED_BY_*	PR_RECEIVED_BY_ADDRTYPE PR_RECEIVED_BY_EMAIL_ADDRESS PR_RECEIVED_BY_ENTRYID PR_RECEIVED_BY_NAME PR_RECEIVED_BY_SEARCH_KEY
PR_RCVD_ REPRESENTING_*	PR_RCVD_REPRESENTING_ADDRTYPE PR_RCVD_REPRESENTING_EMAIL_ADDRESS PR_RCVD_REPRESENTING_ENTRYID PR_RCVD_REPRESENTING_NAME PR_RCVD_REPRESENTING_SEARCH_KEY
PR_REPORT_*	PR_REPORT_ENTRYID PR_REPORT_SEARCH_KEY
PR_READ_RECEIPT_*	PR_READ_RECEIPT_ENTRYID PR_READ_RECEIPT_SEARCH_KEY
PR_CREATOR_*	PR_CREATOR_ENTRYID PR_CREATOR_NAME
PR_LAST_MODIFIER_*	PR_LAST_MODIFIER_ENTRYID PR_LAST_MODIFIER_NAME

The information store provider handles these property groups in specific ways for get, set, and delete operations:

Getting properties Within a given property group, you can get an individual property or properties with a call to IMAPIProp::GetProps. If you are copying message properties by getting properties in one information store and setting them in another, you only need to copy DISPLAY_NAME and ENTRYID; not all the properties in a group. After you set these two properties, the other properties are derived.
Deleting properties Deleting the SEARCH_KEY property has no effect; that is, you can delete it, but a subsequent GetProps operation succeeds because SEARCH_KEY is re-derived. Deleting one or more of ENTRYID, ADDR_TYPE, or EMAIL_ADDRESS has the effect of deleting all three of these properties at once. You can delete the NAME property independently of the other properties.
Setting properties You can set the NAME property independently of the other properties. You can set both the ADDR_TYPE and EMAIL_ADDRESS properties together, or the ENTRYID property alone. If you set ENTRYID, the values of ADDR_TYPE and EMAIL_ADDRESS are re-derived from the new ENTRYID value.

Caution: Do not set ADDR_TYPE or EMAIL_ADDRESS alone. Even if you intend to change the value of only one of these properties, you must still set both for the change to take effect.

Note Every valid entry identifier begins with four bytes of flags followed immediately by a 16-byte GUID. This identifies the entry identifier as type EX (the native address type for Microsoft Exchange Server), MAPI, one-off, or a personal address book (PAB) distribution list (DL). No foreign entry identifiers for recipients are stored in the information store; rather, they are changed into one of the three allowed types. Because they are changed, they might appear different when obtained through a call to IMAPIProp::GetProps than they did when initially saved. Also, a PAB DL will not resolve if the personal address book is unavailable.