ListParts Method

Lists the parts of a multipart upload.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int ListParts(const char* lpszVaultName, const char* lpszUploadId);

Unicode (Windows)
INT ListParts(LPCWSTR lpszVaultName, LPCWSTR lpszUploadId);

- (void)listParts:(NSString*)vaultName :(NSString*)uploadId;

#define MID_AMAZONGLACIER_LISTPARTS 18

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

Remarks

This method lists the parts of a multipart upload specified by UploadId.

VaultName identifies the vault in which the archive is created.

The PartList event will fire once for each Part returned. In addition, the Parts* properties will be populated.

By default up to 1000 parts will be returned in a single set of results. The maximum number of results can be specified by setting MaxListPartResults. If the number of results exceeds the maximum the results are paged. The IsPartPaged setting will be set to true and PartMarker will be populated.

To get all results simply call ListParts again until IsPartPaged returns False and PartMarker is empty string.

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