IDocumentManager.InsertNewFolder Method

Inserts a new document folder into the given document folder.

IDocumentFolder InsertNewFolder(
   IDocumentFolder parentFolder,
   IDocumentFolder newFolder,
   bool inheritSecurity
);

parentFolder: The parent document folder to insert into; cannot be null.
newFolder: The new folder to be inserted. This object may be obtained by calling CreateNewDocumentFolder. Cannot be null.
inheritSecurity: True to override the security set on the IDocumentFolder object and use the same security as the parent folder instead.

A persisted IDocumentFolder. Note: The returned object will be a newly instantiated object and will not be equal to the folder parameter.

This method will need to be called to persist any newly created document folder. The returned IDocumentFolder is the persisted document folder.

Exception Type	Condition
PermissionDeniedException	The user does not have permission to insert a document folder into the given parent folder.
NameAlreadyInUseException	There is already a document or document folder existed in the parent folder with the same name.
CollaborationException	The method call resulted in an error.
SoapException	There is a communication problem during the execution of the remote method call.
InvalidOperationException	The parent folder has not yet been inserted, has already been removed, or the new folder is not new.