The CreateFolder method allows you to create a folder within a Messaging Application Programming Interface (MAPI) top-level hierarchy (TLH) and assign permissions.
The CreateFolder method of the Exchange Provider implements error handling in the following manner:
In general, this method only requires three mandatory input parameters. However, the exception to this is if the folder being created is a top-level folder. If this is the case, then permissions must be set on the folder. The reason for setting permissions is that otherwise, the folder can inherit permissions from the Active Directory service which can make the folder visible outside the hosted organization.
The ModifyFolder method explains how to set folder permissions on a top-level folder. When performing this operation, permissions for the Everyone and Authenticated Users groups are removed from the folder.
The CreateFolder method uses DAV to perform operations and therefore requires the w3svc and related services to be operating. To help ensure a secure environment, the CreateFolder method works with Secure Sockets Layer (SSL) configured. Port 80 is used for non-SSL requests and port 443 is used for SSL connections. The Exchange Provider does not support the use of non-standard ports. Also, with SSL certificates, the server name is expected to be the fully-qualified domain name (FQDN) of the server and not the NetBIOS name. This is the same as ESM.
Exchange should be in native mode to prevent the store from mail-enabling folders by default. Public folders will not be mail-enabled due to issues with creating public folder proxies.
The CreateFolder method calls the DeleteFolder method on transaction rollback.
Example XML Request
Example XML Response
Exchange Provider API for: