CopyItem Method

Copies the specified item into the specified directory.

Syntax

QString CopyItem(const QString& qsItemId, const QString& qsParentId);

Remarks

This method copies the file identified by ItemId to the directory specified by ParentId and returns the Id of the newly created copy. Must call ListItems or GetItemInfo before the Item* properties will be updated with the copied item.

Note that the string root may be used as a ParentId to represent the root folder, and the string home may be used as a folder Id to represent the home folder for the current user. Other special id's include:

• favorites
• allshared
• connectors
• box
• top

// Creates an item in a folder called Parent 1 and copies it to a folder called Parent 2.
string ParentId1 = shareFile.CreateFolder("Parent 1", "home");
string ParentId2 = shareFile.CreateFolder("Parent 2", "home");
string ItemId = shareFile.UploadFile("Test.txt", ParentId1);

string NewId = ShareFile.CopyItem(ItemId, ParentId2);

Error Handling

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.