DeleteChildItems Method

Removes multiple items from a parent item.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int DeleteChildItems(const char* lpszParentId, const char* lpszItemIds);

Unicode (Windows)
INT DeleteChildItems(LPCWSTR lpszParentId, LPCWSTR lpszItemIds);

- (void)deleteChildItems:(NSString*)parentId :(NSString*)itemIds;

#define MID_SHAREFILE_DELETECHILDITEMS 12

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

Remarks

This method deletes multiple files or folders specified by ItemIds permanently. ParentId is the id of the parent item that contains the items that should be deleted. ItemIds is a comma separated list of ItemIds that are going to be deleted permanently. The items must be a child to the specified parent.

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

string ParentId = shareFile.CreateFolder(test, "home");
shareFile.LocalFile = "./test1.txt";
string fileId1 = shareFile.UploadFile("test1.txt", dirId);
shareFile.LocalFile = "./test2.txt";
string fileId2 = shareFile.UploadFile("test2.txt", dirId);
shareFile.DeleteChildItems(ParentId, fileId1 + "," + fileId2);

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)