Article
08/21/2009

DistributionList

Topic Last Modified: 2008-08-26

The DistributionList element represents a distribution list.

Syntax

<DistributionList>
   <MimeContent/>
   <ItemId/>
   <ParentFolderId/>
   <ItemClass/>
   <Subject/>
   <Sensitivity/>
   <Body/>
   <Attachments/>
   <DateTimeReceived/>
   <Size/>
   <Categories/>
   <Importance/>
   <InReplyTo/>
   <IsSubmitted/>
   <IsDraft/>
   <IsFromMe/>
   <IsResend/>
   <IsUnmodified/>
   <InternetMessageHeaders/>
   <DateTimeSent/>
   <DateTimeCreated/>
   <ResponseObjects/>
   <ReminderDueBy/>
   <ReminderIsSet/>
   <ReminderMinutesBeforeStart/>
   <DisplayCc/>
   <DisplayTo/>
   <HasAttachments/>
   <ExtendedProperty/>
   <Culture/>
   <DisplayName/>
   <FileAs/>
   <ContactSource/>
   <EffectiveRights/>
   <ReceivedBy/>
   <ReceivedRepresenting/>
</DistributionList>

Type

DistributionListType

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child Elements

Element	Description
MimeContent	Contains the native MIME stream of an object represented in base64Binary format.
ItemId	Contains the unique identifier and change key of a distribution list item in the Exchange store.
ParentFolderId	Represents the identifier of the parent folder that contains the distribution list item.
ItemClass	Represents the message class of a distribution list item.
Subject	Represents the subject for Exchange store items and response objects.
Sensitivity	Contains the status for a distribution list item's sensitivity.
Body	Represents the actual body content of a distribution list item.
Attachments	Contains the items or files attached to a distribution list item in the Exchange store.
DateTimeReceived	Represents the date and time that a distribution list item in a mailbox was received.
Size	Represents the size in bytes of a distribution list item. This property is read-only.
Categories	Represents a collection of strings that identify to which categories a distribution list item in the mailbox belongs.
Importance	Describes the importance of a distribution list item.
InReplyTo	Represents the identifier of the item which this item is a reply.
IsSubmitted	Indicates whether an item has been submitted to the Outbox default folder.
IsDraft	Represents whether an item has not yet been sent.
IsFromMe	Indicates whether a user sent an item to itself.
IsResend	Indicates whether the item had previously been sent.
IsUnmodified	Indicates whether the item has been modified.
InternetMessageHeaders	Represents the collection of all Internet message headers contained within an item in a mailbox.
DateTimeSent	Represents the date and time that an item in a mailbox was sent.
DateTimeCreated	Represents the date and time that a given item in the mailbox was created.
ResponseObjects	Contains a collection of all the response objects associated with an item in the Exchange store.
ReminderDueBy	Represents the date and time when the event occurs. This is used by the ReminderMinutesBeforeStart element to determine when the reminder is displayed.
ReminderIsSet	Indicates whether a reminder has been set for an item in the Exchange store.
ReminderMinutesBeforeStart	Represents the number of minutes before an event when a reminder is displayed.
DisplayCc	Represents the display string that is used for the contents of the CC line. This is the concatenated string of all CC recipient display names.
DisplayTo	Represents the display string that is used for the contents of the To line. This is the concatenated string of all To recipient display names.
HasAttachments	Represents a property that is set to true if an item has at least one visible attachment. This property is read only.
ExtendedProperty	Identifies extended properties on a distribution list item.
Culture	Represents the culture for a distribution list item in a mailbox.
DisplayName	Defines the display name of a distribution list.
FileAs	Represents how a distribution list is filed in the contacts folder.
ContactSource	Describes whether the contact is located in the Exchange store or Active Directory.
EffectiveRights	Contains the clients rights based on the permission settings for the item or folder. This element is read-only. This element was introduced in Microsoft Exchange Server 2007 Service Pack 1 (SP1).
ReceivedBy	Identifies the delegate in a delegate access scenario. This element was introduced in Microsoft Exchange Server 2007 Service Pack 1 (SP1).
ReceivedRepresenting	Identifies the principal in a delegate access scenario. This element was introduced in Microsoft Exchange Server 2007 Service Pack 1 (SP1).

Parent Elements

Element	Description
AdjacentMeetings	Describes all calendar items that are adjacent to a meeting time.
AppendToItemField	Identifies data to append to a single property of a distribution list during an UpdateItem Operation.
ConflictingMeetings	Identifies all items that conflict with a meeting time.
Create (ItemSync)	Identifies a single distribution list to create in the local client store.
Update (ItemSync)	Identifies a single distribution list to update in the local client store.
Items	Contains an array of items.
Items (CreateItem)	Contains an array of items to create in the folder identified by the ParentFolderId (Create) element.
SetItemField	Represents an update to a single property of a distribution list item in an UpdateItem Operation.

Remarks

The schema that describes this element is located in the EWS virtual directory of the computer that is running Microsoft Exchange Server 2007 that has the Client Access server role installed.

Element Information

Namespace	https://schemas.microsoft.com/exchange/services/2006/types
Schema Name	Types schema
Validation File	Types.xsd
Can be Empty	False