Managed Email 2007::RemoveFolderPermission

Removes permission to an existing public folder.

Arguments

Input Arguments	Required	Description
<organization>	Yes	The 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.
<path>	Yes	The path parameter specified the path\Name of the Public Folder.
<allowedRights>	No	Collection of one or more allowedRight definitions.
<allowedRights/ allowedRight>	Yes	One or more allowedRight definitions.
<server>	No	Specifies the path of the hosted organization that contains the AL, GAL, and OAB as well-known-objects. By default it is the LDAP parent container of the object.

Remarks

In cases where there are multiple Exchange Servers that home the Public Folder Tree Hierarchy, it will be necessary to always pass the optional <server> parameter.

Security

Caller must be at least a member of role: UserCreators.

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 the path\Name of the Public Folder.--> 
    <path>\AlpineSkiHouse\Legal</path> 
    <!--Collection of one or more allowedRight definitions.--> 
    <allowedRights> 
      <!--One or more allowedRight definitions.--> 
      <allowedRight>Publishing Editor</allowedRight> 
    </allowedRights> 
    <!--Specifies the server on which the public folder resides.--> 
    <server>EXMBXOAB01</server> 
  </data> 
  <procedure> 
    <execute namespace="Managed 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="path" 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

• Hosted Messaging and Collaboration version 4.5

• Hosted Messaging and Collaboration version 4.0

See also

Other Resources

API Name [HMC SDK]
API Name [HMC SDK]
API Name [HMC SDK]
API Name [HMC SDK]
API Name [HMC SDK]
API Name [HMC SDK]