CreateFolder Method

Creates a new folder.

Syntax

QString CreateFolder(const QString& qsName, const QString& qsParentId);

Remarks

Creates a new folder and returns the new folder's itemId as a string. Must call ListItems or GetItemInfo before the Item* properties will be updated with the new folder. Name is the name of the folder. ParentId is the id of the parent folder to the newly-created folder.

Note that the string root may be used as a folder Id 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 a folder named parentFolder in the home directory for the authenticated user
string parentId = shareFile.CreateFolder("parentFolder", "home");
// Creates a child folder in the parentFolder. 
string childId = shareFile.CreateFolder("childFolder", parentId);

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.