CreateFolder Method

Creates a new folder.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
char* CreateFolder(const char* lpszName, const char* lpszParentId);

Unicode (Windows)
LPWSTR CreateFolder(LPCWSTR lpszName, LPCWSTR lpszParentId);

- (NSString*)createFolder:(NSString*)name :(NSString*)parentId;

#define MID_SHAREFILE_CREATEFOLDER 8

IPWORKSCLOUD_EXTERNAL int IPWORKSCLOUD_CALL IPWorksCloud_ShareFile_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

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 (C++)

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.