AddBlock Method
Adds a block to the Blocks properties.
Syntax
ANSI (Cross Platform) int AddBlock(const char* lpszId, int iBlockListType); Unicode (Windows) INT AddBlock(LPCWSTR lpszId, INT iBlockListType);
- (void)addBlock:(NSString*)id :(int)blockListType;
#define MID_AZUREBLOB_ADDBLOCK 3 IPWORKSCLOUD_EXTERNAL int IPWORKSCLOUD_CALL IPWorksCloud_AzureBlob_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);
Remarks
This method adds a block to the Block* properties. Id specifies the block's Id, and BlockListType specifies where the server should search for this block.
Block Ids must be Base64-encoded when sent to the server. By default, the class will automatically Base64-encode block Ids as they are sent, and Base64-decode them as they are received. This behavior can be configured using the EncodeBlockIds configuration setting.
All block Ids must be less than or equal to 64 bytes in length before being Base64-encoded. Additionally, all blocks Ids within a single block blob must be unique, and of the exact same length after Base64-encoding.
Valid values for BlockListType are:
Value | Meaning During PutBlockList Operations |
abktCommitted (0) | Search for a committed block with the specified Id. |
abktUncommitted (1) | Search for an uncommitted block with the specified Id. |
abktLatest (2) | Search for an uncommitted block with the specified Id; and then, if one isn't found, search for a committed block. |
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.)