ListParts Method

Lists the parts in a multipart upload.

Syntax

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

Unicode (Windows)
INT ListParts(LPCWSTR lpszObjectName, LPCWSTR lpszUploadId);
- (void)listParts:(NSString*)objectName :(NSString*)uploadId;
#define MID_S3CLIENT_LISTPARTS 23

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

Remarks

This method lists the parts in the multipart upload of ObjectName specified by UploadId. The MaxParts configuration setting may be used to limit the number of results returned.

Calling this method will fire the PartList event once for each part, and will also populate the Parts* 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 Parts* properties.

Note that this method does not need to be called before attempting to complete a multipart upload with CompleteMultipartUpload; the class will automatically collect the necessary information internally. Refer to CompleteMultipartUpload for more information.

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

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