Export (0) Print
Expand All

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

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:

For a complete list of properties, see Mapping Canonical Property Names to MAPI Names.

Show:
© 2014 Microsoft