IMailUser : IMAPIProp
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
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 |
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.