Permission

The Permission element defines the access that a user has to a folder.

<Permission>
   <CanCreateItems/>
   <CanCreateSubfolders/>
   <IsFolderOwner/>
   <IsFolderVisible/>
   <IsFolderContact/>
   <EditItems/>
   <DeleteItems/>
   <PermissionLevel/>
   <ReadItems/>
   <UserId/>
</Permission>

PermissionType

Attributes and elements

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

Attributes

None.

Child elements

Element Description
CanCreateItems
Indicates whether a user has permission to create items in a folder. This element was introduced in Exchange 2007 SP1.
CanCreateSubFolders
Indicates whether a user has permission to create subfolders in a folder. This element was introduced in Exchange 2007 SP1.
DeleteItems
Indicates whether a user has permission to delete items in a folder. This element was introduced in Exchange 2007 SP1.
EditItems
Indicates whether a user has permission to edit items in a folder. This element was introduced in Exchange 2007 SP1.
IsFolderContact
Indicates whether a user is a contact for a folder. This element was introduced in Exchange 2007 SP1.
IsFolderOwner
Indicates whether a user is the owner of a folder. This element was introduced in Exchange 2007 SP1.
IsFolderVisible
Indicates whether a user can view a folder. This element was introduced in Exchange 2007 SP1.
PermissionLevel
Represents the combination of permissions that a user has on a folder. This element was introduced in Exchange 2007 SP1.
ReadItems (PermissionType)
Indicates whether a user has permission to read items within a folder. This element was introduced in Exchange 2007 SP1.
UserId
Identifies a delegate user or a user who has folder access permissions. This element was introduced in Exchange 2007 SP1.

Parent elements

Element Description
Permissions
Contains all the configured permissions for a folder. This element was introduced in Exchange 2007 SP1.

Remarks

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

This element was introduced in Exchange Server 2007 Service Pack 1 (SP1).

Version differences

For applications that target Exchange Online, Exchange Online as part of Office 365, or an on-premises version of Exchange starting with Exchange 2013, folder permissions are not returned when the BaseShape element has a value of AllProperties in the GetFolder operation request. To retrieve folder permissions, add the PermissionSet (PermissionSetType) element to the AdditionalProperties element in the GetFolder request.

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

Setting Folder-Level Permissions