Creating a public folder by using XML

Use the CreateFolder procedure of the Managed Exchange namespace to create a public folder for an Exchange 2000 Server organization.

This procedure performs explicit internal permissions testing. Only members of admins@organization and domain administrators can call this procedure.

Example of a request that calls the CreateFolder procedure

<request>
  <procedure>
	<execute namespace="Managed Exchange" procedure="CreateFolder">
	<executeData>
		<folderPath>myRoot/mySub</folderPath>
		<folderName>f1</folderName>
		<owningOrg>LDAP://ou=Reseller,ou=Hosting,dc=contoso,dc=com</owningOrg>
		<megabytes>100</megabytes>
		<Permissions mode="set">
		<Permission role="Publishing Editor">
			LDAP:// CN=admin1, OU=org1,OU=HostingOU,DC=hostdom, DC=extest,DC=microsoft,DC=com 
		</Permission> 
			<Permission role="Author">
				LDAP:// CN=User1, OU=org1,OU=HostingOU,DC=hostdom, DC=extest,DC=microsoft,DC=com 
		</Permission> 
		</Permissions>
		<preferredDomainController>myPrimaryDC.contoso.com
		</preferredDomainController>
	</executeData>
	</execute>
  </procedure>
</request>

Input for CreateFolder

The following input is valid for this request:

• Folder path

  Use the <folderPath> element to specify the path of the public folder you want to create.

  <folderPath>organization name</folderPath>
  

• Folder name

  Use the <name> element to specify a name for the public folder you want to create.

  <name>folder name</name>
  

• Folder size

  Use the <megabytes> element to specify the size, in megabytes, of the public folder you want to create.

  <megabytes>size of public folder</megabytes>
  

• LDAP path of the owning organization

  Use the <owningOrg> element to specify the Lightweight Directory Access Protocol (LDAP) path of the owning organization.

  <owningOrg>LDAP://LDAP path of the owning organization</user>
  

• Maximum item size

  Use the <MaxItemSize> element to specify the maximum item size in megabytes for this public folder.

  <MaxItemSize>size in megabytes</MaxItemSize>
  

• Group permissions (optional)

  By using the <group permissions> element, you can specify the group to which you want to assign permissions and the permissions you want to assign. To specify permissions for a group, specify the Lightweight Directory Access Protocol (LDAP) path of the group and the type of permissions you want to grant. You can specify the following types of permissions:

  • Author
  • Publisher
  • Reviewer
  • None

  This information is optional.

  <group permissions="group permissions">
  	 LDAP://LDAP path of the group
   </group>
   <group permissions="group permissions"> 
    LDAP://LDAP path of the folder
   </group>
  

Typical response for CreateFolder

The response to this procedure does not contain significant data.

Important

• Although Active Directory is not case sensitive for elements such as the Lightweight Directory Access Protocol (LDAP) path, XML is case sensitive. To ensure that the procedure executes appropriately, specify all tags, elements, and data using uppercase and lowercase letters exactly as shown in the XML examples. For additional guidelines on how to use XML, see the Microsoft Web site (http://www.microsoft.com/).