ObjectList Event

Fires once for each object, object version, or multipart upload returned when listing such items.

Syntax

ANSI (Cross Platform)
virtual int FireObjectList(S3ClientObjectListEventParams *e);
typedef struct {
const char *BucketName;
const char *ObjectName;
const char *LastModified;
int64 Size;
const char *ETag;
const char *OwnerId;
const char *OwnerName;
const char *UploadId;
const char *VersionId;
int LatestVersion;
int Deleted; int reserved; } S3ClientObjectListEventParams; Unicode (Windows) virtual INT FireObjectList(S3ClientObjectListEventParams *e);
typedef struct {
LPCWSTR BucketName;
LPCWSTR ObjectName;
LPCWSTR LastModified;
LONG64 Size;
LPCWSTR ETag;
LPCWSTR OwnerId;
LPCWSTR OwnerName;
LPCWSTR UploadId;
LPCWSTR VersionId;
BOOL LatestVersion;
BOOL Deleted; INT reserved; } S3ClientObjectListEventParams;
- (void)onObjectList:(NSString*)bucketName :(NSString*)objectName :(NSString*)lastModified :(long long)size :(NSString*)ETag :(NSString*)ownerId :(NSString*)ownerName :(NSString*)uploadId :(NSString*)versionId :(BOOL)latestVersion :(BOOL)deleted;
#define EID_S3CLIENT_OBJECTLIST 8

virtual INT IPWORKSS3_CALL FireObjectList(LPSTR &lpszBucketName, LPSTR &lpszObjectName, LPSTR &lpszLastModified, LONG64 &lSize, LPSTR &lpszETag, LPSTR &lpszOwnerId, LPSTR &lpszOwnerName, LPSTR &lpszUploadId, LPSTR &lpszVersionId, BOOL &bLatestVersion, BOOL &bDeleted);

Remarks

This event fires once for each object, object version, or multipart upload returned when GetObjectInfo, ListObjects, ListVersions, or ListMultipartUploads is called.

BucketName reflects the name of the bucket that the object is in.

ObjectName reflects the name of the object.

LastModified reflects the last modified time of the object. Not applicable when ListMultipartUploads is called.

Size reflects the size, in bytes, of the object. Not applicable when ListMultipartUploads is called.

ETag reflects the object's ETag. Not applicable when ListMultipartUploads is called.

OwnerId and OwnerName reflect the Id and display name of the object's owner, respectively. Not applicable when GetObjectInfo is called.

UploadId reflects the Id of the multipart upload. Only applicable when ListMultipartUploads is called.

VersionId reflects the Id of the object version (note that the string null is a valid version Id). Only applicable when ListVersions is called, or when GetObjectInfo is called while VersionId is non-empty; empty in all other cases.

LatestVersion indicates whether this is the latest object version. Only applicable when ListVersions is called; true in all other cases.

Deleted indicates whether this object version is a delete marker (refer to DeleteObject for more information). Only applicable when ListVersions is called, or when GetObjectInfo is called while VersionId is non-empty; false in all other cases.

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