DistributionList

Last modified: May 26, 2010

Applies to: Exchange Server 2007 | Exchange Server 2010

The DistributionList element represents a distribution list.

<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/>
   <EffectiveRights/>
   <LastModifiedName/>
   <LastModifiedTime/>
   <IsAssociated/>
   <WebClientReadFormQueryString/>
   <WebClientEditFormQueryString/>
   <ConversationId/>
   <UniqueBody/>
   <DisplayName/>
   <FileAs/>
   <ContactSource/>
   <Members/>
</DistributionList>

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 that are 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 that are 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.

EffectiveRights

Contains the client's rights based on the permission settings for the item or folder. This element is read-only.

LastModifiedName

Contains the display name of the last user to modify an item.

LastModifiedTime

Indicates when an item was last modified.

IsAssociated

Indicates whether the item is associated with a folder.

WebClientReadFormQueryString

Represents a URL to concatenate to the Microsoft Office Outlook Web App endpoint to read an item in Outlook Web App.

WebClientEditFormQueryString

Represents a URL to concatenate to the Outlook Web App endpoint to edit an item in Outlook Web App.

ConversationId

Contains the identifier of an item or conversation.

UniqueBody

Represents an HTML fragment or plain text which represents the unique body of this conversation.

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 in Active Directory Domain Services (AD DS).

Members

Contains a list of members of the distribution list.

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 (TargetFolderIdType) element.

SetItemField

Represents an update to a single property of a distribution list item in an UpdateItem Operation.

Text Value

None.

Remarks

The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services of the Client Access server.

Element Information

Namespace

https://schemas.microsoft.com/exchange/services/2006/types

Schema Name

Types schema

Validation File

Types.xsd

Can be Empty

False

See Also

Other Resources