Share via

Exchange 2007 Provider::AddFolderPermission

  • Article

This method adds permission to an existing public folder.

Arguments

Input Arguments Required Description

<preferredDomainController>

Yes

The domain controller to use for Active Directory actions.

<user>

Yes

This parameter specifies the user principal name (UPN), domain\user, or alias of the user for whom rights are being added.

<path>

Yes

The path parameter specified the path\Name of the Public Folder.

<allowedRights>

Yes

The collection of one or more allowedRight definitions.

<allowedRights/ allowedRight>

Yes

One or more allowedRight definitions. Enum

  • CreateItems

  • CreateSubfolders

  • DeleteAllItems

  • DeleteOwnedItems

  • EditAllItems

  • EditOwnedItems

  • FolderContact

  • FolderOwner

  • FolderVisible

  • None

  • ReadItems

  • Author

  • Contributor

  • Editor

  • NonEditingAuthor

  • Owner

  • PublishingAuthor ?

  • PublishingEditor

  • Reviewer

<server>

No

This parameter specifies the server on which the public folder resides.

Remarks

Security

The caller must be at least a member of role: UserCreators.

Sample Code

Example XML Request

<request> 
  <data> 
    <!--The domain controller to use for Active Directory actions.--> 
    <preferredDomainController>AD01.Fabrikam.Com</preferredDomainController> 
    <!--The path parameter specified the path\Name of the Public Folder.--> 
    <path>\AlpineSkiHouse\Legal</path> 
    <!--Specifies the user principal name (UPN), domain\user, or alias of the user for whom rights are being added.--> 
    <user>LDAP://CN=johnc@AlpineSkiHouse.com,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</user> 
    <!--Collection of one or more allowedRight definitions.--> 
    <allowedRights> 
      <!--One or more allowedRight definitions.--> 
      <allowedRight>Author</allowedRight> 
    </allowedRights> 
    <!--Specifies the server on which the public folder resides.--> 
    <server>EXMBXOAB01</server> 
  </data> 
  <procedure> 
    <execute namespace="Exchange 2007 Provider" procedure="AddFolderPermission" impersonate="1"> 
      <before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="path" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="user" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="allowedRights" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="server" destination="executeData" mode="move" /> 
      <after source="executeData" destination="data" mode="merge" /> 
    </execute> 
  </procedure> 
</request>

Applies To

Exchange 2007 Provider Namespace for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

See also

Tasks

Hosted Email 2007::CreateFolder
Hosted Email 2007::DeleteFolder
Hosted Email 2007::MailEnableFolder
Hosted Email 2007::MailDisableFolder
Hosted Email 2007::ModifyFolder
Hosted Email 2007::RemoveFolderPermission