ClearPages Method

Clears a range of pages in a page blob.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int ClearPages(const char* lpszPageBlob, int64 lByteOffset, int64 lPageCount);

Unicode (Windows)
INT ClearPages(LPCWSTR lpszPageBlob, LONG64 lByteOffset, LONG64 lPageCount);

- (void)clearPages:(NSString*)pageBlob :(long long)byteOffset :(long long)pageCount;

#define MID_AZUREBLOB_CLEARPAGES 7

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

Remarks

This method clears PageCount pages, from ByteOffset onwards, for the specified PageBlob in the container currently selected by Container.

ByteOffset must be a multiple of 512; i.e. ByteOffset % 512 == 0. PageCount must be a number between 1 and the number of pages in the page blob following ByteOffset (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.)