IPWorks Cloud 2020 C++ Edition

Questions / Feedback?

BlobList Event

Fires once for each blob returned when listing blobs.

Syntax

ANSI (Cross Platform)
virtual int FireBlobList(AzureBlobBlobListEventParams *e);
typedef struct {
const char *Name;
const char *Container;
int BlobType;
const char *Snapshot;
int64 ContentLength;
const char *ContentType;
const char *CreatedTime;
const char *ModifiedTime;
const char *ETag;
int SoftDeleted;
int IsLeased;
int LeaseState; int reserved; } AzureBlobBlobListEventParams; Unicode (Windows) virtual INT FireBlobList(AzureBlobBlobListEventParams *e);
typedef struct {
LPCWSTR Name;
LPCWSTR Container;
INT BlobType;
LPCWSTR Snapshot;
LONG64 ContentLength;
LPCWSTR ContentType;
LPCWSTR CreatedTime;
LPCWSTR ModifiedTime;
LPCWSTR ETag;
BOOL SoftDeleted;
BOOL IsLeased;
INT LeaseState; INT reserved; } AzureBlobBlobListEventParams;
- (void)onBlobList:(NSString*)name :(NSString*)container :(int)blobType :(NSString*)snapshot :(long long)contentLength :(NSString*)contentType :(NSString*)createdTime :(NSString*)modifiedTime :(NSString*)ETag :(BOOL)softDeleted :(BOOL)isLeased :(int)leaseState;
#define EID_AZUREBLOB_BLOBLIST 1

virtual INT IPWORKSCLOUD_CALL FireBlobList(LPSTR &lpszName, LPSTR &lpszContainer, INT &iBlobType, LPSTR &lpszSnapshot, LONG64 &lContentLength, LPSTR &lpszContentType, LPSTR &lpszCreatedTime, LPSTR &lpszModifiedTime, LPSTR &lpszETag, BOOL &bSoftDeleted, BOOL &bIsLeased, INT &iLeaseState);

Remarks

This event fires once for each blob returned when ListBlobs or GetBlobInfo is called.

Name is the name of the blob.

Container is the name of the blob's container.

BlobType is the blob's type. Possible values are:

abtBlockBlob (0) Block blob
abtPageBlob (1) Page blob
abtAppendBlob (2) Append blob

Refer to Azure's Understanding block blobs, append blobs, and page blobs article for more information about blob types.

Snapshot is the snapshot identifier, if the current item represents a blob snapshot; empty otherwise.

ContentLength is the size of the blob's committed data in bytes, for block blobs and append blobs. For page blobs, its the capacity in bytes.

ContentType is the blob's content type. Always empty for uncommitted block blobs.

CreatedTime and ModifiedTime reflect the creation and last modified times of the blob, formatted according to RFC 1123. The latter is always empty for uncommitted block blobs.

ETag is the blob's ETag. Always empty for uncommitted block blobs.

SoftDeleted indicates whether the blob (or snapshot, if Snapshot is non-empty) has been soft-deleted.

IsLeased indicates whether the blob is currently leased. Always false if SoftDeleted is true and/or Snapshot is non-empty.

LeaseState reflects the lease state of the blob. Possible values are:

ablsAvailable (0) The blob's lease is unlocked and can be acquired.
ablsLeased (1) The blob's lease is locked.
ablsExpired (2) The lease duration has expired.
ablsBreaking (3) The lease has been broken, but will continue to be locked until the break period expires.
ablsBroken (4) The lease has been broken, and the break period has expired.

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