Mailbox

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

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

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 (NonEmptyStringType)
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.
GetDelegate
Defines a request to get information about delegates to a mailbox.
RemoveDelegate
Defines a request to remove delegates from a mailbox.
UpdateDelegate
Defines a request to update delegates in a mailbox.
ReceivedBy
Describes the delegate in a delegate access scenario.
ReceivedRepresenting
Describes the principal in a delegate access scenario.
Member
Represents a member of a distribution list.

Text value

None.

Remarks

The EmailAddress (NonEmptyStringType) and ItemId elements identify a mailbox or distribution list.

The EmailAddress (NonEmptyStringType) 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 (NonEmptyStringType) 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 IIS virtual directory that hosts Exchange Web Services.

Element information

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

See also