Hosted Email 2007::RemoveFolderPermission

This procedure removes permission from an existing public folder.

Arguments

Input Arguments	Required	Description
<organization>	Yes	The Lightweight Directory Access Protocol (LDAP) path of the organization.
<preferredDomainController>	Yes	The domain controller to use for Active Directory actions.
<user>	Yes	The LDAP path of the object to grant folder permissions to.
<name>	Yes	The name of the public folder.
<allowedRights>	Yes	The collection of one or more allowedRight definitions.
<allowedRights/ allowedRight>	Yes	One or more allowedRight definitions.
<server>	No	This parameter specifies the server on which the public folder resides. Note parameter server is obsolete in Hosted Messaging and Collaboration version 4.5.

Remarks

Security

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

Schema Definition

Input

<executeData>  
<organization>1..1 </organization> 
<preferredDomainController>1..1 </preferredDomainController> 
<user>1..1 </user> 
<name>1..1 </name> 
<allowedRights>1..1  
<allowedRight>1..unbounded </allowedRight> 
</allowedRights> 
<server>0..1 </server> 
</executeData> 

Output

<executeData>1..1 </executeData>

Sample Code

Example XML Request

<request> 
  <data> 
    <!--The LDAP Path of the organization--> 
    <organization>LDAP://OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</organization> 
    <!--The domain controller to use for Active Directory actions.--> 
    <preferredDomainController>AD01.Fabrikam.Com</preferredDomainController> 
    <!--The user principal name (UPN), Domailn\User, or alias of the user.--> 
    <user>Admins@AlpineSkiHouse</user> 
    <!--The path parameter specified themame of the Public Folder.--> 
    <name>Legal</name> 
    <!--Collection of one or more allowedRight definitions.--> 
    <allowedRights> 
      <!--One or more allowedRight definitions.--> 
      <allowedRight>Publishing Editor</allowedRight> 
    </allowedRights> 
    <!--Obsolete. Specifies the server on which the public folder resides.--> 
    <server>EXMBXOAB01</server> 
  </data> 
  <procedure> 
    <execute namespace="Hosted Email 2007" procedure="RemoveFolderPermission" impersonate="1"> 
      <before source="data" sourcePath="organization" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="user" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="name" 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> 

Example XML Response

<response>  
        <data /> 
</response> 

Applies To

Hosted Email 2007 Namespace for:

• Hosted Messaging and Collaboration version 4.5

• Hosted Messaging and Collaboration version 4.0

See also

Tasks

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