SendCustomRequest Method
Sends a custom request to the Azure Blob Storage service.
Syntax
int SendCustomRequest(const QString& qsHttpMethod, const QString& qsBlob, const QString& qsRequestBody);
Remarks
This method can be used to send arbitrary requests to the Azure Blob Storage service.
Valid values for HttpMethod are:
- GET (default if empty)
- HEAD
- POST
- PUT
- DELETE
The Blob and RequestBody parameters may be empty if not needed.
Usage
When this method is called, the class does the following:
- Builds a request URL, including query parameters, using the following:
- Adds request headers from:
- APIVersion
- LeaseId (if non-empty)
- IfMatch (if non-empty)
- OtherHeaders
- Authenticates the request using Authorization (if non-empty), or AccessKey (in which case the request is signed).
- Sends the request, including RequestBody if non-empty.
- Stores the response headers in the ParsedHeader* properties; and the response body in the specified LocalFile, or BlobData (using the same logic as GetBlob).
If the response body is XML data, the XPath, XText, and other X* configuration settings can then be used to navigate and extract information from it.
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.)