Unicode C

Streaming Download Large File to the Local Filesystem

See more Azure Cloud Storage Examples

Downloads a large file in a streaming fashion to the local filesystem. Unicode C

#include <C_CkRestW.h>
#include <C_CkAuthAzureStorageW.h>
#include <C_CkStreamW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkRestW rest;
    BOOL bTls;
    int port;
    BOOL bAutoReconnect;
    HCkAuthAzureStorageW azAuth;
    int responseStatusCode;
    HCkStreamW bodyStream;
    const wchar_t *errResponse;

    success = FALSE;

    // Azure File Service Example: Downloads a large file to the local filesystem using a Chilkat stream.
    // See:  https://docs.microsoft.com/en-us/rest/api/storageservices/get-file

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    rest = CkRestW_Create();

    // Connect to the Azure Storage Blob Service
    bTls = TRUE;
    port = 443;
    bAutoReconnect = TRUE;
    // In this example, the storage account name is "chilkat".
    success = CkRestW_Connect(rest,L"chilkat.file.core.windows.net",port,bTls,bAutoReconnect);
    if (success != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkRestW_Dispose(rest);
        return;
    }

    // Provide Azure Cloud credentials for the REST calls.
    azAuth = CkAuthAzureStorageW_Create();
    CkAuthAzureStorageW_putAccessKey(azAuth,L"AZURE_ACCESS_KEY");
    // The account name used here should match the 1st part of the domain passed in the call to Connect (above).
    CkAuthAzureStorageW_putAccount(azAuth,L"chilkat");
    CkAuthAzureStorageW_putScheme(azAuth,L"SharedKey");
    CkAuthAzureStorageW_putService(azAuth,L"File");
    // This causes the "x-ms-version: 2021-08-06" header to be automatically added.
    CkAuthAzureStorageW_putXMsVersion(azAuth,L"2021-08-06");
    success = CkRestW_SetAuthAzureStorage(rest,azAuth);

    // Note: The application does not need to explicitly set the following
    // headers: x-ms-date, Authorization.  These headers
    // are automatically set by Chilkat.

    // When streaming a download to the local filesystem or directed elsewhere,
    // the complete HTTP GET operation must be broken into parts.
    // For example, an HTTP GET consists of sending the request, followed by reading the response header,
    // and then finally the response body.  We'll want to read the response header, and then based
    // on the information received (such as success or failure), either read the response body
    // as an error message, or as the file data.

    // Send the HTTP GET request to download the file.
    // The share is named "pip".
    success = CkRestW_SendReqNoBody(rest,L"GET",L"/pip/somethingBig.zip");
    if (success != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkRestW_Dispose(rest);
        CkAuthAzureStorageW_Dispose(azAuth);
        return;
    }

    // Read the response header.
    responseStatusCode = CkRestW_ReadResponseHeader(rest);
    if (responseStatusCode < 0) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkRestW_Dispose(rest);
        CkAuthAzureStorageW_Dispose(azAuth);
        return;
    }

    wprintf(L"Response status code = %d\n",responseStatusCode);

    // We expect a 200 response status if the file data is coming.
    // Otherwise, we'll get a string response body with an error message(or no response body).
    if (responseStatusCode == 200) {

        bodyStream = CkStreamW_Create();

        // The stream's sink will be a file.
        CkStreamW_putSinkFile(bodyStream,L"qa_output/somethingBig.zip");

        // Read the response body to the stream.  Given that we've
        // set the stream's sink to a file, it will stream directly
        // to the file.
        success = CkRestW_ReadRespBodyStream(rest,bodyStream,TRUE);
        if (success != TRUE) {
            wprintf(L"%s\n",CkRestW_lastErrorText(rest));
            CkRestW_Dispose(rest);
            CkAuthAzureStorageW_Dispose(azAuth);
            CkStreamW_Dispose(bodyStream);
            return;
        }

        wprintf(L"Successfully received the large file.\n");

    }
    else {
        errResponse = CkRestW_readRespBodyString(rest);
        if (CkRestW_getLastMethodSuccess(rest) != TRUE) {
            wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        }
        else {
            wprintf(L"%s\n",errResponse);
        }

    }



    CkRestW_Dispose(rest);
    CkAuthAzureStorageW_Dispose(azAuth);
    CkStreamW_Dispose(bodyStream);

    }