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 |