Prefix Property

A prefix used to restrict the results returned when listing blobs or containers.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
char* GetPrefix();
int SetPrefix(const char* lpszPrefix);

Unicode (Windows)
LPWSTR GetPrefix();
INT SetPrefix(LPCWSTR lpszPrefix);

@property (nonatomic,readwrite,assign,getter=prefix,setter=setPrefix:) NSString* prefix;
- (NSString*)prefix;
- (void)setPrefix:(NSString*)newPrefix;

#define PID_AZUREBLOB_PREFIX 69

IPWORKSCLOUD_EXTERNAL void* IPWORKSCLOUD_CALL IPWorksCloud_AzureBlob_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);
IPWORKSCLOUD_EXTERNAL int IPWORKSCLOUD_CALL IPWorksCloud_AzureBlob_Set(void *lpObj, int propid, int arridx, const void *val, int cbVal);

Default Value

""

Remarks

This property, if non-empty, is used to restrict the results returned by ListBlobs or ListContainers to only the items whose names begin with the given value.

Blob Namespace Traversal

By using the BlobDelimiter and Prefix properties in tandem, applications can effectively "traverse" a virtual hierarchy of blobs as if it were a filesystem. For example, assume that blobs with the following names exist within a container:

• MyCompany
• MyCompany/Department1
• MyCompany/Department2
• MyCompany/Department2/EmployeeA
• MyCompany/Department2/EmployeeB

With BlobDelimiter set to /, we can set Prefix to successively "deeper" values before calling ListBlobs for the following effect:

This property is not available at design time.

Data Type

String