ListMultipartUploads Method

Lists the in-progress multipart uploads in a bucket.

Syntax

int ListMultipartUploads(const QString& qsBucketId);

Remarks

This method lists the in-progress multipart uploads in the bucket specified by BucketId.

Before calling this method, the Prefix property may be set in order to restrict the results to only the multipart uploads whose file names begin with the a given string.

If the currently-authenticated application key is restricted to a specific file name prefix (indicated by the AccountAllowedPrefix property being non-empty), then the Prefix property will automatically be set to that prefix if it is empty when this method is called.

Calling this method will fire the FileList event once for each multipart upload, and will also populate the File* properties. If the ListWithMetadata configuration setting is enabled, the MetadataList event will also be fired, once for each metadata item associated with each multipart upload.

The currently-authenticated application key must have the listFiles capability to call this method successfully, otherwise the server will return an error. Refer to the AccountCapabilities property for more information.

Error Handling

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