Platform SDK: MAPI

IDistList : IMAPIContainer

The IDistList interface is used to provide access to distribution lists in modifiable address book containers. IDistList can create, copy, and delete distribution lists, in addition to performing name resolution.

Quick Info

Header file: MAPIDEFS.H
Exposed by: Distribution list objects
Implemented by: Address book providers
Called by: Client applications
Interface identifier: IID_IDistList
Pointer type: LPDISTLIST
Transaction model: Transacted

Vtable Order

No unique methods

Required properties Access
PR_ADDRTYPE Read/write
PR_DISPLAY_NAME Read/write
PR_ENTRYID Read-only
PR_OBJECT_TYPE Read-only
PR_RECORD_KEY Read-only

Remarks

The IDistList interface inherits from IMAPIContainer and includes the same methods as address book containers. Therefore, because the methods of the IDistList interface are identical to those of the IABContainer interface, they are not redocumented here.

A distribution list — or object that implements IDistList — is a collection of messaging user objects, or individual recipients. A distribution list can be made up of all messaging user objects, or some messaging user and some distribution lists.

There are typically two types of distribution lists:

Optional distribution list properties include:

PR_LAST_MODIFICATION_TIME

PR_DISPLAY_TYPE

PR_DETAILS_TABLE

Notice that PR_ADDRTYPE is required, but PR_EMAIL_ADDRESS is not. That is because a distribution list without an e-mail address can still receive messages, but its member list must be expanded. If the PR_ADDRTYPE property is set to MAPIPDL, MAPI performs the expansion. If PR_ADDRTYPE is a value other than MAPIPDL, the transport provider performs the expansion.

For further information on using the IDistList methods, see the reference entries for the parallel methods of IABContainer.