Article
08/21/2009

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

Share via