Click here to Skip to main content
Click here to Skip to main content

Asynchronous WinHTTP Library

, 10 Dec 2009 CPOL
Rate this:
Please Sign up or sign in to vote.
Tiny WinHTTP API wrapper library for asynchronous HTTP with callback handler


The AsyncWinHttp is a simple wrapper of WinHTTP to achieve asynchronous HTTP. WinHtpp API is a replacement of WinINet API (see About WinHTTP for more information of why Microsoft recommends to use WinHttp API).

The library provides a very simple interface, the user can register a callback function when initializing the class. And the callback will be invoked when HTTP finished. The interface is shown as:


This code is based on the sample of WinHTTP from MSDN, with a wrapper for simple use. 

Using the Code

To use the library is very simple, all you need is the two files:

  • AsyncWinHttp.h
  • AsyncWinHttp.cpp

First, you need to define your callback functions. These functions will be invoked when HTTP finished (whether succeeded or failed):

void WinHttp_CallBack(AsyncWinHttp* asyncWinHttp)
  // check if success or failed
  if (asyncWinHttp->status.Status() == ASYNC_WINHTTP_ERROR)
    // print error message
    printf("%S", asyncWinHttp->status.Desc().c_str());
  else // success
    // print response, do your handling here ...
    std::string response;
    printf("%s", response.c_str());

Now you can invoke the request to HTTP resources:

  AsyncWinHttp http;
  http.SetTimeout(3 * 60 * 1000);  // time out is 3 minutes

Of course, you can use a Windows event to wait for the asynchronous HTTP call to finish, as shown in the demo, but I think most of you will not do so, since we need a really asynchronous HTTP. Wink | ;)


  • 11th December, 2009: Initial post 


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author


China China
No Biography provided

Comments and Discussions

QuestionHello, the code maybe has memory leakage [modified] Pinmemberfluxischarge24-Jun-13 12:27 
BugStatus code not getting set on successful SendRequest PinmemberMember 978173110-Apr-13 10:12 
Questionuse with proxy model and response error 12030 Pinmemberdavid_jiang9-Apr-13 4:57 
Generalan error :REQUEST_ERROR - error 12002, result API_RECEIVE_RESPONSE Pinmemberjackinelee23-Apr-10 22:43 
GeneralRe: an error :REQUEST_ERROR - error 12002, result API_RECEIVE_RESPONSE Pinmemberzoufeiyy25-Mar-12 3:41 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.150123.1 | Last Updated 11 Dec 2009
Article Copyright 2009 by zoufeiyy
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid