本篇内容讲述 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 的使用流程,可以根据这个 流程图 学习接下来的知识点:
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,打开后点击创建项目:
选择控制台程序:
接下来编写完项目名称点击下一步即可:
接下来在 右侧解决方案资源管理器 下的 SourceFiles 中找到 main.cpp 进行代码编写即可:
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);
结果如下:
下载器输出完整代码
该部分完整代码如下:
#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>
接在在下图所示处开始添加代码:
此时添加的代码如下:
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
写入数据(不会的可以查一下文档,这个很简单)。
最后关闭 文件操作 即可。
运行程序完毕后,已下载内容到磁盘中:
文章来源:https://www.toymoban.com/news/detail-428391.html
下载器完整代码
此时修改过的完整下载器代码如下:文章来源地址https://www.toymoban.com/news/detail-428391.html
#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);
}
到了这里,关于C++ winhttp 实现文件下载器的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!