Sample code for 30+ languages & platforms
Unicode C

Explaining the Rest ClearResponseBodyStream Method

See more Azure Cloud Storage Examples

The ClearResponseBodyStream method would be needed if your applicaiton called SetResponseBodyStream to send the response to a stream for one request, but then wants to subsequently do something else. The application must call ClearResponseBodyStream to no longer send responses to the stream.

Chilkat Unicode C Downloads

Unicode C
#include <C_CkRestW.h>
#include <C_CkStreamW.h>
#include <C_CkBinDataW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkRestW rest;
    BOOL bTls;
    int port;
    BOOL bAutoReconnect;
    HCkStreamW fileStream;
    int expectedStatus;
    const wchar_t *responseStr;
    HCkBinDataW bd;

    success = FALSE;

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

    rest = CkRestW_Create();

    //  Connect to the web server
    bTls = TRUE;
    port = 443;
    bAutoReconnect = TRUE;
    success = CkRestW_Connect(rest,L"www.chilkatsoft.com",port,bTls,bAutoReconnect);
    if (success != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkRestW_Dispose(rest);
        return;
    }

    //  Setup a file stream for the download
    fileStream = CkStreamW_Create();
    CkStreamW_putSinkFile(fileStream,L"qa_output/starfish.jpg");

    //  Indicate that the call to FullRequestNoBody should send the response body
    //  to fileStream if the response status code is 200.
    //  If a non-success response status code is received, then nothing
    //  is streamed to the output file and the error response is returned by FullRequestNoBody.
    expectedStatus = 200;
    CkRestW_SetResponseBodyStream(rest,expectedStatus,TRUE,fileStream);

    responseStr = CkRestW_fullRequestNoBody(rest,L"GET",L"/images/starfish.jpg");
    if (CkRestW_getLastMethodSuccess(rest) == FALSE) {
        //  Examine the request/response to see what happened.
        wprintf(L"response status code = %d\n",CkRestW_getResponseStatusCode(rest));
        wprintf(L"response status text = %s\n",CkRestW_responseStatusText(rest));
        wprintf(L"response header: %s\n",CkRestW_responseHeader(rest));
        wprintf(L"response body (if any): %s\n",responseStr);
        wprintf(L"---\n");
        wprintf(L"LastRequestStartLine: %s\n",CkRestW_lastRequestStartLine(rest));
        wprintf(L"LastRequestHeader: %s\n",CkRestW_lastRequestHeader(rest));
        CkRestW_Dispose(rest);
        CkStreamW_Dispose(fileStream);
        return;
    }

    wprintf(L"downloaded starfish.jpg\n");

    //  Clear the response body stream previously set in the call to SetResponseBodyStream.
    CkRestW_ClearResponseBodyStream(rest);

    //  Download something else, but this time send the response body to bd.
    bd = CkBinDataW_Create();
    success = CkRestW_FullRequestNoBodyBd(rest,L"GET",L"/images/penguins.jpg",bd);
    if (success == FALSE) {
        //  Examine the request/response to see what happened.
        wprintf(L"response status code = %d\n",CkRestW_getResponseStatusCode(rest));
        wprintf(L"response status text = %s\n",CkRestW_responseStatusText(rest));
        wprintf(L"response header: %s\n",CkRestW_responseHeader(rest));
        wprintf(L"response body (if any): %s\n",CkBinDataW_getString(bd,L"utf-8"));
        wprintf(L"---\n");
        wprintf(L"LastRequestStartLine: %s\n",CkRestW_lastRequestStartLine(rest));
        wprintf(L"LastRequestHeader: %s\n",CkRestW_lastRequestHeader(rest));
        CkRestW_Dispose(rest);
        CkStreamW_Dispose(fileStream);
        CkBinDataW_Dispose(bd);
        return;
    }

    //  Save the contents of bd to a file.
    success = CkBinDataW_WriteFile(bd,L"qa_output/penguins.jpg");

    wprintf(L"Success: %d\n",success);


    CkRestW_Dispose(rest);
    CkStreamW_Dispose(fileStream);
    CkBinDataW_Dispose(bd);

    }