ListBlocks Method
Lists the blocks associated with a block blob.
Syntax
int ListBlocks(const QString& qsBlockBlob, int iBlockListType);
Remarks
This method lists the blocks associated with the specified BlockBlob in the container currently selected by Container. BlockListType indicates which block list(s) the server should return results from; possible values are:
| Committed (0) | Only committed blocks are listed. The blocks are returned in the same order that they were committed in by the most recent PutBlockList operation. |
| Uncommitted (1) | Only uncommitted blocks are listed. The blocks are returned in alphabetical order by Id. |
| All (2) | Both committed and uncommitted blocks are listed. The committed blocks are returned before the uncommitted blocks. |
Alternatively, if Snapshot is non-empty, the committed blocks for the specified snapshot of BlockBlob are listed instead (and BlockListType is ignored).
Calling this method will fire the BlockList event once for each block, and will also repopulate the Block* properties.
Error Handling
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.)