Mailbox

Topic Last Modified: 2008-09-08

The Mailbox element identifies a mail-enabled Active Directory directory service object.

Syntax

<Mailbox>
   <Name/>
   <EmailAddress/>
   <RoutingType/>
   <MailboxType/>
   <ItemId/>
</Mailbox>

Type

EmailAddressType

Attributes and Elements

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

Attributes

None.

Child Elements

Element Description

Name (EmailAddressType)

Defines the name of the mailbox user. This element is optional.

EmailAddress

Defines the Simple Mail Transfer Protocol (SMTP) address of a mailbox user. This element is optional.

RoutingType (EmailAddress)

Defines the routing that is used for the mailbox. The default is SMTP. This element is optional.

MailboxType

Defines the mailbox type of a mailbox user. This element is optional.

ItemId

Defines the item identifier of a contact or private distribution list for recipients from a user's contacts folder. This element is optional.

Parent Elements

Element Description

ExpandDL

Defines a request to expand a distribution list.

The following is the XPath expression to this element: /ExpandDL

ToRecipients

Contains an array of recipients of an item.

CcRecipients

Represents a collection of recipients that will receive a copy of the message.

BccRecipients

Represents a collection of recipients to receive a blind carbon copy (Bcc) of an e-mail.

ReplyTo

Identifies an array of e-mail addresses to which replies should be sent.

Sender

Identifies the sender of an item.

From

Represents the addressee from whom the message was sent.

Organizer

Represents the organizer of a meeting.

DistinguishedFolderId

Identifies default Microsoft Exchange Server 2007 folders.

The following are the XPath expressions to this element:

  • /CreateItem/ParentFolderId/DistinguishedFolderId
  • /CreateFolder/ParentFolderId/DistinguishedFolderId

Resolution

Contains a single resolved entity.

DLExpansion

Contains an array of mailboxes that are contained in a distribution list.

Attendee

Represents attendees and resources for a calendar item.

CreateManagedFolder

Defines a request to add managed folders to a mailbox.

AddDelegate

Defines a request to add delegates to a mailbox. This element was introduced in Microsoft Exchange Server 2007 Service Pack 1 (SP1).

GetDelegate

Defines a request to get information about delegates to a mailbox. This element was introduced in Exchange 2007 SP1.

RemoveDelegate

Defines a request to remove delegates from a mailbox. This element was introduced in Exchange 2007 SP1.

UpdateDelegate

Defines a request to update delegates in a mailbox. This element was introduced in Exchange 2007 SP1.

ReceivedBy

Describes the delegate in a delegate access scenario. This element was introduced in Microsoft Exchange Server 2007 Service Pack 1 (SP1).

ReceivedRepresenting

Describes the principal in a delegate access scenario. This element was introduced in Exchange 2007 SP1.

Remarks

The EmailAddress and ItemId elements identify a mailbox or distribution list. The EmailAddress element identifies a mailbox or distribution list by SMTP address. The ItemId element identifies a mailbox by an item identifier, which is associated with a particular mailbox. The ItemId element cannot be used for sending a message to a distribution list or a contact in a public contacts folder. An error will be thrown if this is used in a CreateItem, UpdateItem, or SendItem operation when an attempt is made to send a message to a distribution list or contact in a contacts public folder. Use the ExpandDL operation to get the SMTP address and then send the message by using the EmailAddress element instead of the ItemId element.

Another element, Mailbox (Availability), provides information for availability operations.

The schema that describes this element is located in the EWS directory of the computer that is running Exchange 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

See Also

Other Resources

Exchange Web Services XML Elements