IMailUser : IMAPIProp
Last modified: July 23, 2011
Applies to: Outlook
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.
|
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 |
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 |
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.