MoveResource Method

Moves a resource.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int MoveResource(const char* lpszResourceId, const char* lpszParentId, const char* lpszNewName);

Unicode (Windows)
INT MoveResource(LPCWSTR lpszResourceId, LPCWSTR lpszParentId, LPCWSTR lpszNewName);

- (void)moveResource:(NSString*)resourceId :(NSString*)parentId :(NSString*)newName;

#define MID_BOX_MOVERESOURCE 20

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

Remarks

This method moves the resource specified by ResourceId to the folder specified by ParentId.

NewName specifies the new name of the resource; if empty, the resource's original name is used. ParentId can also be empty, in which case the resource is moved to the root folder.

NewName must be no longer than 255 characters; may not contain /, \, non-printable ASCII characters, or trailing whitespace; and cannot be one of the special names . or ...

When moving a folder that contains many items, keep in mind that Box always performs move operations synchronously (whereas copy operations are performed asynchronously for folders that contain more than 500 items). This method will block until the move operation completes, unless the class times out the request based on the current value of Timeout.

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.)