UpdatePageBlob Method

Updates a page blob's size and/or sequence number.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int UpdatePageBlob(const char* lpszPageBlob, int64 lNewSize, int iSequenceNumAction, int64 lNewSequenceNum);

Unicode (Windows)
INT UpdatePageBlob(LPCWSTR lpszPageBlob, LONG64 lNewSize, INT iSequenceNumAction, LONG64 lNewSequenceNum);

- (void)updatePageBlob:(NSString*)pageBlob :(long long)newSize :(int)sequenceNumAction :(long long)newSequenceNum;

#define MID_AZUREBLOB_UPDATEPAGEBLOB 38

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

Remarks

This method updates the size and/or sequence number of the specified PageBlob in the container currently selected by Container.

NewSize must either be -1 (to keep the page blob's current size), or a multiple of 512; i.e. NewSize % 512 == 0. If NewSize is less than the page blob's current size, all pages above the specified value are cleared.

SequenceNumAction determines how the page blob's sequence number should be changed; possible values are:

In cases where NewSequenceNum is used, it must be a value in the range 0 to 2^63 - 1, inclusive.

If the specified blob has an active lease, its lease Id must be specified using LeaseId, or the request will fail.

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