本篇内容讲述 C++ winHttp 实现下载器的简单 demo，使用了 WinHttpOpen、WinHttpConnect、WinHttpOpenRequest、WinHttpSendRequest、WinHttpReceiveResponse、WinHttpQueryDataAvailable、WinHttpReadData、WinHttpCloseHandle 等函数。

版权声明：本文为CSDN博主「1_bit」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/A757291228/article/details/129974019

文章参考 Microsoft doc WinHttp：https://learn.microsoft.com/zh-cn/windows/win32/WinHttp/winhttp-start-page
本机环境：VisualStudio 2022 、 Windows10
想要完整代码请到文章末尾

一、WinHttp

WinHttp 是 Windows 提供的可创建网络请求的一组 API，包括 http、https、代理等；WinHttp 的 Microsoft doc 链接为 https://learn.microsoft.com/zh-cn/windows/win32/WinHttp/winhttp-start-page，若需要查看详细的文档说明，可进入 Microsoft doc 进行查看。

二、WinHttp 的使用

本篇文章只简单的介绍如何使用 WinHttp，并不涉及其原理，包括 http、https 协议不再讲解。关于不讲解的原因为思考后，发现即使不会协议，也能很好的使用 WinHttp，当然可能对于某些“复杂”的业务逻辑或特殊需求并不好处理，可能也会对于某些错误信息无法判断，若出现这种情况，建议读者再去了解 http、https 等协议，当然本人之后也会出相关的协议讲解的文章，但在本篇，我们只讨论如何使用 C++ WinHttp 进行网络请求。

在 Microsoft doc 中，有介绍 C++ WinHttp 的使用流程，可以根据这个流程图学习接下来的知识点：

C++ winhttp 实现文件下载器-LMLPHP

2.1 WinHttp 的 http 一般使用流程

使用 C++ WinHttp 发送一个 Http 请求，需要经过以下流程：WinHttpOpen->WinHttpConnect->WinHttpOpenRequest->WinHttpSendRequest->WinHttpReceiveResponse->WinHttpQueryDataAvailable->WinHttpReadData->WinHttpCloseHandle

以上所述内容只需要先有一个印象，接下来会对其进行详细说明。

对于以上流程用中文的进行解释为：WinHttpOpen （初始化 WinHttp ）->WinHttpConnect （指定 Http 请求的初始目标服务器）->WinHttpOpenRequest （创建 HTTP 请求句柄）->WinHttpSendRequest （指定请求发送到 Http 服务器） ->WinHttpReceiveResponse （等待 WinHttpSendRequest 发起的 HTTP 请求的响应） ->WinHttpQueryDataAvailable （读取数据大小） ->WinHttpReadData**（读取数据）** ->WinHttpCloseHandle （关闭连接）

2.2 VisualStduio 环境准备

本机环境使用的 VS 版本为2022，打开后点击创建项目：

C++ winhttp 实现文件下载器-LMLPHP
选择控制台程序：

C++ winhttp 实现文件下载器-LMLPHP
接下来编写完项目名称点击下一步即可：

接下来在右侧解决方案资源管理器下的 SourceFiles 中找到 main.cpp 进行代码编写即可：

C++ winhttp 实现文件下载器-LMLPHP

2.3 WinHttpOpen 初始化 WinHttp

在了解了 WinHttp 的一般步骤后，首先开始读 WinHttp 的初始化操作。一个 WinHttp 的函数圆形如下：

WINHTTPAPI HINTERNET WinHttpOpen(
  [in, optional] LPCWSTR pszAgentW,
  [in]           DWORD   dwAccessType,
  [in]           LPCWSTR pszProxyW,
  [in]           LPCWSTR pszProxyBypassW,
  [in]           DWORD   dwFlags
);

WinHttpOpen 接收 5 个参数，分别是 pszAgentW、dwAccessType、pszProxyW、pszProxyBypassW、dwFlags，其中：

pszAgentW：表示代理名称 agent name
dwAccessType：表示如何http（假定）如何进行请求可选
pszProxyW：表示若使用代理则在此处填写对应的代理服务器和端口号可选
pszProxyBypassW：表示绕过的代理服务器主机名
dwFlags：表示使用某些特定的组合选项

在以上的解释中，对于网络知识薄弱的同学可能会感到一头雾水，在此使用一个示例进行说明：

hSession = WinHttpOpen(
L"My User Agent Name",
WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
WINHTTP_NO_PROXY_NAME,
WINHTTP_NO_PROXY_BYPASS,
0);

以上是一个 WinHttpOpen 的代码示例，其中参数：

pszAgentW 设置为了 "My User Agent Name"，这就是我们的代理名称为 "My User Agent Name"，或者你想用其他名称也行。
dwAccessType 设置为了 WINHTTP_ACCESS_TYPE_DEFAULT_PROXY 表示使用默认代理设置，也就是说当前本机的默认网络代理设置是什么就是什么，或者说咱们没有什么特殊的代理需求时，设置为 WINHTTP_ACCESS_TYPE_DEFAULT_PROXY 即可。
pszProxyW 设置为了 WINHTTP_NO_PROXY_NAME 表示当前的请求不使用代理。毕竟在上一个设置时咱们设置了使用默认代理，那么理应设置成不适用代理（当然，你可能当前本机是有代理，默认了，那么也是走那个默认的代理去请求的）。
pszProxyBypassW 设置为了 WINHTTP_NO_PROXY_BYPASS 则表示不绕过任何的主机，则使用当前的默认代理进行访问。
dwFlags 设置为 0 表示打开会话时不使用特定的选项，该怎样就怎样。

以上设置中 dwAccessType 还可以设置成 WINHTTP_ACCESS_TYPE_NO_PROXY 与 WINHTTP_ACCESS_TYPE_NAMED_PROXY，其中：

WINHTTP_ACCESS_TYPE_NO_PROXY 表示直接链接到目标服务器不使用代理
WINHTTP_ACCESS_TYPE_NAMED_PROXY 表示使用目标代理

接下来在 VS 2022 中添加 WinHttp 头文件对其引入：

#include <Winhttp.h>

并且需要添加对应的编译指示器，指定库文件链接：

#pragma comment(lib, "winhttp.lib")

为了方便接下来的操作，咱们顺势将其他头文件引入：

#include <Windows.h>
#include <iostream>

接着创建一个 HINTERNET 句柄对象用于接收 WinHttp 初始化后的句柄：

HINTERNET hSession = NULL;

此时还可以在之后进行判断，是否初始化成功：

if (!hSession) {
    std::cerr << "WinHttp 打开错误 \n";
    return 1;
}

接着就可以复制以上示例代码到 main.cpp 文件中了，此时的 main.cpp 文件代码如下：

#include "pch.h"
#include <Windows.h>
#include <iostream>
#include <Winhttp.h>
#pragma comment(lib, "winhttp.lib")

using namespace winrt;
using namespace Windows::Foundation;

int main()
{
    HINTERNET hSession = NULL;
    hSession = WinHttpOpen(
        L"My User Agent",
        WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
        WINHTTP_NO_PROXY_NAME,
        WINHTTP_NO_PROXY_BYPASS,
        0);
    if (!hSession) {
        std::cerr << "WinHttp 打开错误 \n";
        return 1;
    }
}

2.3 WinHttpConnect 指定 Http 请求的初始目标服务器

完成了 WinHttp 初始化后，使用 WinHttpConnect 指定 Http 的目标服务器，WinHttpConnect 函数原型如下：

WINHTTPAPI HINTERNET WinHttpConnect(
  [in] HINTERNET     hSession,
  [in] LPCWSTR       pswzServerName,
  [in] INTERNET_PORT nServerPort,
  [in] DWORD         dwReserved
);

WinHttpConnect 接收 4 个参数：

hSession：为 WinHttp 初始化后的句柄
pswzServerName：为目标服务器名，域名或IP
nServerPort：为指定的端口，如果是 HTTP 就是80，若是 HTTPS 就是 443
dwReserved：保留参数，设置为 0 即可，不用管，文档也是这样写的

以上参数中 nServerPort 可以设置为：

INTERNET_DEFAULT_HTTP_PORT：使用 HTTP 服务器的默认端口 (端口 80)
INTERNET_DEFAULT_HTTPS_PORT：使用 HTTPS 服务器的默认端口 (端口 443) 。

此时该函数可编写为：

HINTERNET hConnect = NULL;
hConnect = WinHttpConnect(
	hSession,
	L"demo.com",//此处填写你要进行 http 请求的 hostname 或 ip
	80,
	0
);

2.4 WinHttpOpenRequest 创建 HTTP 请求句柄

WinHttpOpenRequest 创建 HTTP 请求句柄，函数原型如下：

WINHTTPAPI HINTERNET WinHttpOpenRequest(
  [in] HINTERNET hConnect,
  [in] LPCWSTR   pwszVerb,
  [in] LPCWSTR   pwszObjectName,
  [in] LPCWSTR   pwszVersion,
  [in] LPCWSTR   pwszReferrer,
  [in] LPCWSTR   *ppwszAcceptTypes,
  [in] DWORD     dwFlags
);

hConnect 为 WinHttpConnect 返回的 HINTERNET 句柄。
pwszVerb 请求类型参数，例如 GET，需要大写
pwszObjectName url 请求参数
pwszVersion 指定 HTTP 版本，默认为 NULL，使用 HTTP/1.1
pwszReferrer 表示请求的来源地址，如果没有其他页面跳转到目标请求，那么设置为 NULL，也可以使用 WINHTTP_NO_REFERER 代替
ppwszAcceptTypes 表示 HTTP 请求可接受的 MIME 类型，例如 “application/json”、“text/html”，设置为 WINHTTP_DEFAULT_ACCEPT_TYPES 表示使用 WinHTTP 默认的 MIME 类型设置
dwFlags 若不需要设置任何特殊标志和选项那么设置为 0 即可

dwFlags 参数还可以设置为 WINHTTP_FLAG_SECURE、WINHTTP_FLAG_ESCAPE_PERCENT、WINHTTP_FLAG_NULL_CODEPAGE、WINHTTP_FLAG_BYPASS_PROXY_CACHE：

WINHTTP_FLAG_SECURE 表示使用 HTTPS 链接，默认情况下 winHttp 使用 HTTP
WINHTTP_FLAG_ESCAPE_PERCENT 表示在请求之前对 URL 中的 % 进行转义
WINHTTP_FLAG_NULL_CODEPAGE 表示无需为响应的 Unicode 字符串指定代码页
WINHTTP_FLAG_BYPASS_PROXY_CACHE 表示绕过服务器缓存直接请求服务器内容

那么以上函数可写成：

HINTERNET hRequest = NULL;
hRequest = WinHttpOpenRequest(
    hConnect, L"GET",
    L"disk.exe",
    NULL,
    WINHTTP_NO_REFERER,
    WINHTTP_DEFAULT_ACCEPT_TYPES,
    0);
if (!hRequest) {
    std::cerr << "WinHttpOpenRequest 错误 \n";
    WinHttpCloseHandle(hConnect);
    WinHttpCloseHandle(hSession);
    return 1;
}

2.5 WinHttpSendRequest 指定请求发送到 Http 服务器

函数原型如下：

WINHTTPAPI BOOL WinHttpSendRequest(
  [in]           HINTERNET hRequest,
  [in, optional] LPCWSTR   lpszHeaders,
  [in]           DWORD     dwHeadersLength,
  [in, optional] LPVOID    lpOptional,
  [in]           DWORD     dwOptionalLength,
  [in]           DWORD     dwTotalLength,
  [in]           DWORD_PTR dwContext
);

参数说明：

hRequest： Request WinHTTP 请求句柄
pwszHeaders：如果没有要添加的标头，则为 NULL 或者为 WINHTTP_NO_ADDITIONAL_HEADERS
dwHeadersLength：pwszHeaders 参数以字节为单位的长度，若 pwszHeaders 为 NULL，则此参数为 0
lpOptional：要发送到服务器的数据，如果没有要发送的数据，则为 NULL 或 WINHTTP_NO_REQUEST_DATA
dwOptionalLength：lpOptional 以字节为单位的长度，lpOptional 为 NULL，则此参数为 0
dwTotalLength：请求的总长度，没有标头也没有数据，则为 0。
dwContext：用于指定调用方自定义的上下文值，在请求完成后可以通过回调函数获取该值，不需要设置回调则为 0

此时代码可以编写为如下：

bResults = WinHttpSendRequest(hRequest,
    WINHTTP_NO_ADDITIONAL_HEADERS, 0,
    WINHTTP_NO_REQUEST_DATA, 0,
    0, 0);
if (!bResults) {
    std::cerr << "WinHttpSendRequest 错误 \n";
    WinHttpCloseHandle(hRequest);
    WinHttpCloseHandle(hConnect);
    WinHttpCloseHandle(hSession);
    return 1;
}

2.6 WinHttpReceiveResponse 等待 WinHttpSendRequest 发起的 HTTP 请求的响应

函数原型如下：

WINHTTPAPI BOOL WinHttpReceiveResponse(
  [in] HINTERNET hRequest,
  [in] LPVOID    lpReserved
);

hRequest ：已通过 WinHttpSendRequest 函数发送请求并返回的 WinHTTP 请求句柄。
等待 WinHttpSendRequest 完成此句柄，然后再调用 WinHttpReceiveResponse。
lpReserved：保留参数设置为 NULL。

此时代码如下：

bResults = WinHttpReceiveResponse(hRequest, NULL);
if (!bResults) {
    std::cerr << "WinHttpReceiveResponse 错误 \n";
    WinHttpCloseHandle(hRequest);
    WinHttpCloseHandle(hConnect);
    WinHttpCloseHandle(hSession);
    return 1;
}

2.7 WinHttpQueryDataAvailable 读取数据大小

接下来使用 WinHttpQueryDataAvailable 读取数据大小，方便接下来读取数据到某一个 buf 之中。

WinHttpQueryDataAvailable 函数原型如下：

WINHTTPAPI BOOL WinHttpQueryDataAvailable(
  [in]  HINTERNET hRequest,
  [out] LPDWORD   lpdwNumberOfBytesAvailable
);

hRequest：WinHttpSendRequest 的 WinHTTP 句柄
lpdwNumberOfBytesAvailable：尚未读取的响应数据的大小

此时代码如下：

DWORD dwSize = 0;
LPSTR pszOutBuffer = NULL;
dwSize = 0;
WinHttpQueryDataAvailable(hRequest, &dwSize);
pszOutBuffer = new char[dwSize + 1];
ZeroMemory(pszOutBuffer, dwSize + 1);//清空 pszOutBuffer

2.8 WinHttpReadData 读取数据

WinHttpReadData 函数将会读取还没有读取的数据，函数原型如下：

WINHTTPAPI BOOL WinHttpReadData(
  [in]  HINTERNET hRequest,
  [out] LPVOID    lpBuffer,
  [in]  DWORD     dwNumberOfBytesToRead,
  [out] LPDWORD   lpdwNumberOfBytesRead
);

hRequest：WinHttpSendRequest 的 WinHTTP 句柄
lpBuffer：buf 指针存储读取数据
dwNumberOfBytesToRead：读取数据的字节数大小
lpdwNumberOfBytesRead：此时实际读取数据的字节数

由于此时 WinHttpReadData 返回的是 BOOL，那么直接 while 进行读取即可，当然，也可以 lpdwNumberOfBytesRead 为 0 时 break：

while (WinHttpReadData(hRequest, (LPVOID)pszOutBuffer, dwSize, &dwDownloaded)) {
   if (dwDownloaded == 0)
       break;
}

此时读取的是 exe 二进制流数据，咱们可以直接 cout 输出，代码如下：

std::cout << pszOutBuffer;
delete[] pszOutBuffer;
WinHttpCloseHandle(hRequest);
WinHttpCloseHandle(hConnect);
WinHttpCloseHandle(hSession);

结果如下：

C++ winhttp 实现文件下载器-LMLPHP

下载器输出完整代码

该部分完整代码如下：

#include "pch.h"
#include <Windows.h>
#include <iostream>
#include <Winhttp.h>
#pragma comment(lib, "winhttp.lib")

using namespace winrt;
using namespace Windows::Foundation;

int main()
{
    HINTERNET hSession = NULL;
    HINTERNET hConnect = NULL;
    HINTERNET hRequest = NULL;

    DWORD dwSize = 0;
    LPSTR pszOutBuffer = NULL;
    DWORD dwDownloaded = 0;
    bool bResults = false;

    hSession = WinHttpOpen(
        L"My User Agent",
        WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
        WINHTTP_NO_PROXY_NAME,
        WINHTTP_NO_PROXY_BYPASS,
        0);
    if (!hSession) {
        std::cerr << "WinHttp 打开错误 \n";
        return 1;
    }

    hConnect = WinHttpConnect(
        hSession,
        L"hostname or ip",
        80,
        0);

    if (!hConnect) {
        std::cerr << "WinHttpConnect 错误 \n";
        WinHttpCloseHandle(hSession);
        return 1;
    }

    hRequest = WinHttpOpenRequest(
        hConnect, L"GET",
        L"disk.exe",
        NULL,
        WINHTTP_NO_REFERER,
        WINHTTP_DEFAULT_ACCEPT_TYPES,
        0);
    if (!hRequest) {
        std::cerr << "WinHttpOpenRequest 错误 \n";
        WinHttpCloseHandle(hConnect);
        WinHttpCloseHandle(hSession);
        return 1;
    }

    bResults = WinHttpSendRequest(hRequest,
        WINHTTP_NO_ADDITIONAL_HEADERS, 0,
        WINHTTP_NO_REQUEST_DATA, 0,
        0, 0);
    if (!bResults) {
        std::cerr << "WinHttpSendRequest 错误 \n";
        WinHttpCloseHandle(hRequest);
        WinHttpCloseHandle(hConnect);
        WinHttpCloseHandle(hSession);
        return 1;
    }

    bResults = WinHttpReceiveResponse(hRequest, NULL);
    if (!bResults) {
        std::cerr << "WinHttpReceiveResponse 错误 \n";
        WinHttpCloseHandle(hRequest);
        WinHttpCloseHandle(hConnect);
        WinHttpCloseHandle(hSession);
        return 1;
    }

    dwSize = 0;
    WinHttpQueryDataAvailable(hRequest, &dwSize);
    pszOutBuffer = new char[dwSize + 1];
    ZeroMemory(pszOutBuffer, dwSize + 1);

    while (WinHttpReadData(hRequest, (LPVOID)pszOutBuffer, dwSize, &dwDownloaded)) {
        if (dwDownloaded == 0)
            break;
    }

    std::cout << pszOutBuffer;
    delete[] pszOutBuffer;
    WinHttpCloseHandle(hRequest);
    WinHttpCloseHandle(hConnect);
    WinHttpCloseHandle(hSession);

}

三、代码更改成下载程序并保存

想要更改以上示例下载文件保存到磁盘步骤简单，首先引入 fstream 头文件：

#include <fstream>

接在在下图所示处开始添加代码：

C++ winhttp 实现文件下载器-LMLPHP
此时添加的代码如下：

std::ofstream outfile("C:\\demo.exe", std::ios::binary);

此时表示输出内容到 C:\\demo.exe 下保存，当然 demo.exe 是你的文件名。

接着创建一个 BYTE 对象为缓冲区：

BYTE buffer[1024];

修改原有的 while 循环读取如下：

while (WinHttpReadData(hRequest, buffer, sizeof(buffer), &dwDownloaded)) {
    outfile.write(reinterpret_cast<const char*>(buffer), dwDownloaded);
    if (dwDownloaded == 0)
        break;
}
outfile.close();

此时读取到的缓冲区变成了 buffer，并且在读取后，在使用 outfile.write 写入数据（不会的可以查一下文档，这个很简单）。

最后关闭文件操作即可。

运行程序完毕后，已下载内容到磁盘中：

C++ winhttp 实现文件下载器-LMLPHP

下载器完整代码

此时修改过的完整下载器代码如下：

#include "pch.h"
#include <Windows.h>
#include <iostream>
#include <Winhttp.h>
#include <fstream>
#pragma comment(lib, "winhttp.lib")

using namespace winrt;
using namespace Windows::Foundation;

int main()
{
    HINTERNET hSession = NULL;
    HINTERNET hConnect = NULL;
    HINTERNET hRequest = NULL;

    DWORD dwSize = 0;
    LPSTR pszOutBuffer = NULL;
    DWORD dwDownloaded = 0;
    bool bResults = false;

    hSession = WinHttpOpen(
        L"My User Agent",
        WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
        WINHTTP_NO_PROXY_NAME,
        WINHTTP_NO_PROXY_BYPASS,
        0);
    if (!hSession) {
        std::cerr << "WinHttp 打开错误 \n";
        return 1;
    }

    hConnect = WinHttpConnect(
        hSession,
        L"hostname",
        80,
        0);

    if (!hConnect) {
        std::cerr << "WinHttpConnect 错误 \n";
        WinHttpCloseHandle(hSession);
        return 1;
    }

    hRequest = WinHttpOpenRequest(
        hConnect, L"GET",
        L"disk.exe",
        NULL,
        WINHTTP_NO_REFERER,
        WINHTTP_DEFAULT_ACCEPT_TYPES,
        0);
    if (!hRequest) {
        std::cerr << "WinHttpOpenRequest 错误 \n";
        WinHttpCloseHandle(hConnect);
        WinHttpCloseHandle(hSession);
        return 1;
    }

    bResults = WinHttpSendRequest(hRequest,
        WINHTTP_NO_ADDITIONAL_HEADERS, 0,
        WINHTTP_NO_REQUEST_DATA, 0,
        0, 0);
    if (!bResults) {
        std::cerr << "WinHttpSendRequest 错误 \n";
        WinHttpCloseHandle(hRequest);
        WinHttpCloseHandle(hConnect);
        WinHttpCloseHandle(hSession);
        return 1;
    }

    bResults = WinHttpReceiveResponse(hRequest, NULL);
    if (!bResults) {
        std::cerr << "WinHttpReceiveResponse 错误 \n";
        WinHttpCloseHandle(hRequest);
        WinHttpCloseHandle(hConnect);
        WinHttpCloseHandle(hSession);
        return 1;
    }

    //dwSize = 0;
    //WinHttpQueryDataAvailable(hRequest, &dwSize);
    //pszOutBuffer = new char[dwSize + 1];
    //ZeroMemory(pszOutBuffer, dwSize + 1);

    std::ofstream outfile("C:\\demo.exe", std::ios::binary);
    BYTE buffer[1024];
    while (WinHttpReadData(hRequest, buffer, sizeof(buffer), &dwDownloaded)) {
        outfile.write(reinterpret_cast<const char*>(buffer), dwDownloaded);
        if (dwDownloaded == 0)
            break;
    }
    outfile.close();

    /*
    while (WinHttpReadData(hRequest, (LPVOID)pszOutBuffer, dwSize, &dwDownloaded)) {
        if (dwDownloaded == 0)
            break;
    }
    */
    //std::cout << pszOutBuffer;
    //delete[] pszOutBuffer;
    WinHttpCloseHandle(hRequest);
    WinHttpCloseHandle(hConnect);
    WinHttpCloseHandle(hSession);

}