Contact Properties

From OpenChange wiki

Contents 1 About 2 Property notes 2.1 PR_ALTERNATE_RECIPIENT_ALLOWED (PT_BOOLEAN) 2.2 PR_HASATTACH 2.3 0x8008101e 2.4 0x8010001e, 0x8011001e, 0x8012001e 2.5 0x8013001e, 0x8014001e, 0x8015001e 2.6 0x8023001e 2.7 0x8022001e 2.8 0x800d001e 2.9 0x800f001e 2.10 0x8016001e 2.11 0x8019101e 2.12 0x82f5001e

About

This is a few notes on MAPI Properties used for Contacts (as opposed to mail messages or some other type of information). Most of the information is self-explanatory from the property tag value (e.g. PR_SURNAME is the string containing the surname), but some of the fields are either not fully known, or the usage isn't obvious).

Property notes

PR_ALTERNATE_RECIPIENT_ALLOWED (PT_BOOLEAN)

This is used to represent whether the contact is "Private" or not. The Outlook GUI has a checkbox (bottom RH corner of the edit window in Outlook 2003) that is set (checked) when this is false.

PR_HASATTACH

If this is present (and true), then the contact has a photo attached. If you want it, you need to access it via the attachment table: - call GetAttachmentTable to get the attachment table, - get the number of attachments from the PR_ATTACH_NUM property in the attachment table (I've only ever seen one, but you should check) - open each attachment (using the OpenAttach function) - then check the filename (expect "ContactPicture.jpg" ) for each attachment - try PR_ATTACH_FILENAME and also the PR_ATTACH_LONG_FILENAME properties - get the size of the photo data stream as PR_ATTACH_SIZE, and the photo data itself as PR_ATTACH_DATA_BIN.

0x8008101e

This appears to be the "categories" list. Outlook has a default list of categories (Business, Holidays, Favourites, etc), and then allows you to add your own. There doesn't appear to be any difference at the MAPI level though - you just get one label for each entry in the list.

0x8010001e, 0x8011001e, 0x8012001e

These are the email addresses (outlook calls them Email, Email2 and Email3), in an undecorated format (e.g. "bradh@kde.org"). There is another copy of these addresses later (at 0x801f001e, 0x8020001e and 0x8021001e) but I haven't got to the end of that yet.

0x8013001e, 0x8014001e, 0x8015001e

These are a decorated form of the email addresses from above (e.g. "Brad Hards (bradh@kde.org)"). Outlook shows this as "Display as".

0x8023001e

This is the "web page address" or "business web page" in Outlook (depending on where you look).

0x8022001e

This is the "IM address" from Outlook.

0x800d001e

This appears to be some kind of formatted form of the work address (without the country)

0x800f001e

This appears to be some kind of formatted form of the home address (without the country)

0x8016001e

Possibly the "File as" target

0x8019101e

List of the "Contacts". Not sure what this is actually meant to be used for, but it matches the button on the bottom LH corner of the Outlook edit window.

0x82f5001e

As for 0x8019101e, but as a semi-colon delimited list.