IMailUser : IMAPIProp

Applies to: Office 2010 | Outlook 2010 | Visual Studio

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:

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

See Also

Concepts

MAPI Interfaces