IMailUser : IMAPIProp
Applies to: Outlook 2013 | Outlook 2016
Provides access to the many properties that are associated with messaging users. The IMailUser interface is implemented by messaging user objects. IMailUser inherits from the IMAPIProp : IUnknown interface and has no unique methods of its own.
| Property | Value |
|---|---|
| Header file: |
Mapidefs.h |
| Exposed by: |
Messaging user objects |
| Implemented by: |
Address book providers |
| Called by: |
Client applications |
| Interface identifier: |
IID_IMailUser |
| Pointer type: |
LPMAILUSER |
| Transaction model: |
Transacted |
Vtable order
This interface does not have any unique methods.
| Required properties | Access |
|---|---|
| PR_ADDRTYPE (PidTagAddressType) |
Read/write |
| PR_DISPLAY_NAME (PidTagDisplayName) |
Read/write |
| PR_DISPLAY_TYPE (PidTagDisplayType) |
Read-only |
| PR_EMAIL_ADDRESS (PidTagEmailAddress) |
Read/write |
| PR_ENTRYID (PidTagEntryId) |
Read-only |
| PR_OBJECT_TYPE (PidTagObjectType) |
Read-only |
| PR_RECORD_KEY (PidTagRecordKey) |
Read-only |
| PR_SEARCH_KEY (PidTagSearchKey) |
Read-only |
Remarks
Five of the required properties are known as the base address properties for recipients:
PR_ADDRTYPE
PR_DISPLAY_NAME
PR_EMAIL_ADDRESS
PR_ENTRYID
PR_SEARCH_KEY
These properties are considered special because many other groups of similar properties are built upon this base group. The other groups are used to describe a recipient in various roles, such as a message's original or delegate sender. For more information about these properties and how to use them, see MAPI Address Types.
Messaging users can display a collection of their properties by supporting the PR_DETAILS_TABLE (PidTagDetailsTable) property. PR_DETAILS_TABLE is a display table that describes the layout of a details dialog box or a tabbed property page that displays recipient property information. MAPI creates details dialog boxes when a client calls the IAddrBook::Details method.
Messaging user objects can have other optional properties associated with them. MAPI defines many properties that provide additional addressing information about a messaging user. All of these properties are character strings. The following list shows the more commonly used properties:
PR_ACCOUNT (PidTagAccount)
PR_ASSISTANT (PidTagAssistant)
PR_BUSINESS_TELEPHONE_NUMBER (PidTagBusinessTelephoneNumber)
PR_GIVEN_NAME (PidTagGivenName)
PR_GOVERNMENT_ID_NUMBER (PidTagGovernmentIdNumber)
PR_LOCALITY (PidTagLocality)
PR_POSTAL_ADDRESS (PidTagPostalAddress)
For a complete list of properties, see Mapping Canonical Property Names to MAPI Names.