ListParts Method

Lists a multipart upload's parts.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int ListParts(const char* lpszMultipartFileId);

Unicode (Windows)
INT ListParts(LPCWSTR lpszMultipartFileId);

- (void)listParts:(NSString*)multipartFileId;

#define MID_BACKBLAZEB2_LISTPARTS 28

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

Remarks

This method lists the parts that have been created for the multipart file upload specified by MultipartFileId.

Calling this method will fire the PartList event once for each part, and will also populate the Part* properties.

If there are still more parts available to list when this method returns, the PartMarker property will be populated. Continue to call this method until PartMarker is empty to accumulate all pages of results in the Part* properties.

The MaxPartResults configuration setting can be used to control the maximum number of results returned each time this method is called.

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

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