DeleteBlob Method
Deletes a blob.
Syntax
ANSI (Cross Platform) int DeleteBlob(const char* lpszBlob, int iDeleteAction); Unicode (Windows) INT DeleteBlob(LPCWSTR lpszBlob, INT iDeleteAction);
- (void)deleteBlob:(NSString*)blob :(int)deleteAction;
#define MID_AZUREBLOB_DELETEBLOB 13 IPWORKSCLOUD_EXTERNAL int IPWORKSCLOUD_CALL IPWorksCloud_AzureBlob_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);
Remarks
This method deletes the specified Blob in the container currently selected by Container. DeleteAction specifies how the delete operation should be handled; possible values are:
| Single (0) | Only delete the specified blob. The request will fail if any snapshots of the blob exist. |
| Snapshots Only (1) | Delete all of the specified blob's snapshots, but not the blob itself. |
| Everything (2) | Delete the specified blob and all of its snapshots. |
Alternatively, if Snapshot is non-empty, the specified snapshot of Blob is deleted, and DeleteAction is ignored.
If the current Azure Storage account, specified by Account, has a delete retention policy enabled for the Blob service, then this method will only soft-delete blobs (and snapshots). Soft-deleted blobs and snapshots can be listed by enabling the IncludeSoftDeleted configuration setting before calling ListBlobs, and can be undeleted at any point before their retention period expires by calling UndeleteBlob.
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.)