IFolderManager.CreateFolder Method

Creates a new IFolder instance.

IFolder CreateFolder(
IFolder parentFolder,
string name
);

parentFolder: The parent folder to insert into; cannot be null.
name: The name of the folder; cannot be null, empty, or longer than 255 characters. The string used for the name will be trimmed of leading and trailing whitespace when it is stored and is case-insensitive during name comparison. If there is already a folder in the parent folder with the same name a NameAlreadyInUseException will be thrown when IFolder.Store is called.

A new IFolder instance.

The method IFolder.Store must be called to persist this newly-created folder.

The security level of a newly-created, persisted folder will inherit the security of its parent folder by default.

An InvalidOperationException will be thrown if the parent folder has not been stored.

Exception Type	Condition
InvalidOperationException	The specified parent folder has not yet been stored or has been removed.
ArgumentException	The name is an empty string or longer than 255 characters.