Unicode C

Cancel HTTP Get Async Task if not Completed after a Max Time

See more HTTP Examples

Demonstrates how to wait a maximum amount of time for an asynchronous task to completed. If not completed in the allotted amount of time, the task is cancelled. Unicode C

#include <C_CkHttpW.h>
#include <C_CkTaskW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttpW http;
    const wchar_t *url;
    HCkTaskW task;
    int waitMaxMs;
    BOOL wasCanceled;
    const wchar_t *responseStr;

    success = FALSE;

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

    http = CkHttpW_Create();

    // Set some timeouts, in seconds:
    CkHttpW_putConnectTimeout(http,15);
    // ReadTimeout specifies the max number of seconds that must elapse when no additional data is received before
    // timing out.  For example, if a server sends a 300 byte response at the rate of 1 byte per second, then
    // ReadTimeout would never cause a timeout because there is never a 15 second interval when nothing arrives.
    CkHttpW_putReadTimeout(http,15);

    url = L"https://your-url.com/something";
    task = CkHttpW_QuickGetStrAsync(http,url);
    CkTaskW_Run(task);

    // Wait a maximum of waitMaxMs for the task (i.e. the HTTP GET) to complete.
    // The Wait method returns when the task has been canceled, aborted, or completed, or when the max allotted time has passed.
    waitMaxMs = 20000;
    CkTaskW_Wait(task,waitMaxMs);

    // At this point, the GET may or may not have completed.  
    // Rather than checking the Task status, we can call task.Cancel because
    // if the Task is no longer running (because it already completed, was canceled or aborted), then the 
    // call to Cancel is a NO-OP (meaning it does nothing and the Task's status is unaffected).
    // Also, task.Cancel returns TRUE if the task was in the "queued" or "running" state and was canceled or aborted. 
    // The method returns FALSE if the task has any other status.
    wasCanceled = CkTaskW_Cancel(task);
    if (wasCanceled == TRUE) {
        wprintf(L"The HTTP GET took too long and was canceled.\n");
    }
    else {
        // Find out what happened.
        if (CkTaskW_getStatusInt(task) == 7) {
            // The task completed, which means the background thread's call to QuickGetStr completed
            // with success or failure.  Find out which...
            if (CkTaskW_getTaskSuccess(task) == TRUE) {
                // Get the string response for the call to QuickGetStr (which happened in Chilkat's background thread).
                responseStr = CkTaskW_getResultString(task);
                wprintf(L"%s\n",responseStr);
                wprintf(L"HTTP GET successful!\n");
            }
            else {
                wprintf(L"HTTP GET failed prior to waitMaxMs...\n");
                wprintf(L"%s\n",CkTaskW_resultErrorText(task));
            }

        }
        else {
            // The task must've been canceled or aborted by some other means..
            wprintf(L"Task did not complete.  Final status: %s\n",CkTaskW_status(task));
        }

    }

    CkTaskW_Dispose(task);


    CkHttpW_Dispose(http);

    }