StartMultipartUpload Method

Starts a new multipart upload.


ANSI (Cross Platform)
char* StartMultipartUpload(const char* lpszObjectName);

Unicode (Windows)
LPWSTR StartMultipartUpload(LPCWSTR lpszObjectName);
- (NSString*)startMultipartUpload:(NSString*)objectName;

IPWORKSS3_EXTERNAL int IPWORKSS3_CALL IPWorksS3_S3Client_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);


This method starts a new multipart upload for an object named ObjectName, in the bucket currently selected by Bucket, and returns the upload Id that the server associates with it. This upload Id can then be used to call the following methods:

If there are any metadata items present in the Metadata* properties, they will be included in the creation request, and will be applied to the final object after the multipart upload is completed with CompleteMultipartUpload.

Multipart uploads never expire, they must be explicitly completed or aborted using CompleteMultipartUpload or AbortMultipartUpload. The ListMultipartUploads method can be used to retrieve a list of current multipart uploads.

Note: This method is not supported when ServiceProvider is spGoogleStorage (2); Google Cloud Storage does not support multipart uploads.

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.

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks S3 2020 C++ Edition - Version 20.0 [Build 8164]