3.1.4.7 Copying a Folder and Its Contents

To copy particular messages from one folder to another, the client sends a RopMoveCopyMessages ROP request ([MS-OXCROPS] section 2.2.4.6) with the WantCopy field set to nonzero (TRUE), as specified in section 2.2.1.6.1. The client's request includes a list of MIDs ([MS-OXCDATA] section 2.2.1.2) that specify the messages to be copied.

To copy a folder from one parent folder to another, the client sends a RopCopyFolder ROP request ([MS-OXCROPS] section 2.2.4.8). All of the messages in the source folder are duplicated in the new folder. If the WantRecursive field is set to nonzero (TRUE), as specified in section 2.2.1.8.1, the subfolders that are contained in the source folder are also duplicated in the new folder.

The RopMoveCopyMessages ROP request and RopCopyFolder ROP request are processed asynchronously if the client sets the WantAsynchronous field of the request to nonzero (TRUE), as specified in sections 2.2.1.6.1 and 2.2.1.7.1. For details about asynchronous processing, see section 3.1.5.2.