DataFlex

Download a Binary File into Memory

See more Azure Cloud Storage Examples

Downloads a binary file into memory. DataFlex

Use ChilkatAx-win32.pkg

Procedure Test
    Boolean iSuccess
    Handle hoRest
    Boolean iBTls
    Integer iPort
    Boolean iBAutoReconnect
    Variant vAzAuth
    Handle hoAzAuth
    Variant vBdFileContents
    Handle hoBdFileContents
    Handle hoSbXmlErr
    String sTemp1
    Integer iTemp1

    Move False To iSuccess

    // Azure File Service Example: Download a Binary File to Memory
    // 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.

    Get Create (RefClass(cComChilkatRest)) To hoRest
    If (Not(IsComObjectCreated(hoRest))) Begin
        Send CreateComObject of hoRest
    End

    // Connect to the Azure Storage Blob Service
    Move True To iBTls
    Move 443 To iPort
    Move True To iBAutoReconnect
    // In this example, the storage account name is "chilkat".
    Get ComConnect Of hoRest "chilkat.file.core.windows.net" iPort iBTls iBAutoReconnect To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoRest To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // Provide Azure Cloud credentials for the REST calls.
    Get Create (RefClass(cComChilkatAuthAzureStorage)) To hoAzAuth
    If (Not(IsComObjectCreated(hoAzAuth))) Begin
        Send CreateComObject of hoAzAuth
    End
    Set ComAccessKey Of hoAzAuth To "AZURE_ACCESS_KEY"
    // The account name used here should match the 1st part of the domain passed in the call to Connect (above).
    Set ComAccount Of hoAzAuth To "chilkat"
    Set ComScheme Of hoAzAuth To "SharedKey"
    Set ComService Of hoAzAuth To "File"
    // This causes the "x-ms-version: 2021-08-06" header to be automatically added.
    Set ComXMsVersion Of hoAzAuth To "2021-08-06"
    Get pvComObject of hoAzAuth to vAzAuth
    Get ComSetAuthAzureStorage Of hoRest vAzAuth To iSuccess

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

    // Send a GET request to download the file "penguins.jpg" to a BinData object.
    // (The share name is "pip")
    Get Create (RefClass(cComChilkatBinData)) To hoBdFileContents
    If (Not(IsComObjectCreated(hoBdFileContents))) Begin
        Send CreateComObject of hoBdFileContents
    End
    Get pvComObject of hoBdFileContents to vBdFileContents
    Get ComFullRequestNoBodyBd Of hoRest "GET" "/pip/wildlife/antarctic/penguins.jpg" vBdFileContents To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoRest To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // When successful, the response status will be 200.
    // If a non-success status code is returned, then the bdFileContents actually contains the XML error message.
    Get ComResponseStatusCode Of hoRest To iTemp1
    If (iTemp1 <> 200) Begin
        // Examine the request/response to see what happened.
        Get ComResponseStatusCode Of hoRest To iTemp1
        Showln "response status code = " iTemp1
        Get ComResponseStatusText Of hoRest To sTemp1
        Showln "response status text = " sTemp1
        Get ComResponseHeader Of hoRest To sTemp1
        Showln "response header: " sTemp1
        Get Create (RefClass(cComChilkatStringBuilder)) To hoSbXmlErr
        If (Not(IsComObjectCreated(hoSbXmlErr))) Begin
            Send CreateComObject of hoSbXmlErr
        End
        Get pvComObject of hoBdFileContents to vBdFileContents
        Get ComAppendBd Of hoSbXmlErr vBdFileContents "utf-8" 0 0 To iSuccess
        Get ComGetAsString Of hoSbXmlErr To sTemp1
        Showln "response body (if any): " sTemp1
        Showln "---"
        Get ComLastRequestStartLine Of hoRest To sTemp1
        Showln "LastRequestStartLine: " sTemp1
        Get ComLastRequestHeader Of hoRest To sTemp1
        Showln "LastRequestHeader: " sTemp1
        Procedure_Return
    End

    Get ComNumBytes Of hoBdFileContents To iTemp1
    Showln "Size of the downloaded file = " iTemp1

    // See the online reference documentation for the BinData class for ways
    // to access the bytes.

    Get ComWriteFile Of hoBdFileContents "qa_output/penguins.jpg" To iSuccess


End_Procedure