CreateSnapshot Method
Creates a new snapshot of a blob.
Syntax
ANSI (Cross Platform) char* CreateSnapshot(const char* lpszBlob); Unicode (Windows) LPWSTR CreateSnapshot(LPCWSTR lpszBlob);
- (NSString*)createSnapshot:(NSString*)blob;
#define MID_AZUREBLOB_CREATESNAPSHOT 12 IPWORKSCLOUD_EXTERNAL int IPWORKSCLOUD_CALL IPWorksCloud_AzureBlob_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);
Remarks
This method creates a new snapshot of the specified Blob in the container currently selected by Container, and returns the opaque DateTime value used to identify the newly-created snapshot.
If the SendMetadataOnSnapshot configuration setting is enabled when this method is called, all items in the Metadata* properties will be sent in the request and applied to newly-created snapshot. Otherwise, the server will copy the metadata items from Blob to the snapshot.
If the specified blob has an active lease, a lease Id may optionally be specified using LeaseId; the request will only succeed if the correct lease Id is specified.
Error Handling (C++)
This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its 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.