Windows API-Wininet&WinHTTP
July 11, 2020 10:33 PM
WinInet
WinInet(“Windows Internet”)API帮助程序员使用三个常见的Internet协议,这三个协议是用于World Wide Web万维网的超文本传输协议(HTTP:Hypertext Transfer Protocol)、文件传输协议(FTP:File Transfer Protocol)和另一个称为Gopher的文件传输协议。WinInet函数的语法与常用的Win32 API函数的语法类似,这使得使用这些协议就像使用本地硬盘上的文件一样容易。
WinInet 概述
⊙ Hinternet 句柄的层次关系
⊙ HTTP 函数层次关系
⊙ 典型的 HTTP 客户端程序的处理流程
1、普通 WinInet 处理函数
⊙ InternetOpen 初始化 WinInet.dll
⊙ InternetOpenUrl 打开 Url,读取数据
⊙ InternetAttemptConnect 尝试建立到 Internet 的连接
⊙ InternetConnect 建立 Internet 的连接
⊙ InternetCheckConnection 检查 Internet 的连接是否能够建立
⊙ InternetSetOption 设置一个 Internet 选项
⊙ InternetSetStausCallback 安装一个回调函数,供 API 函数调用
⊙ InternetQueryOption 查询在一个指定句柄上的 Internet 选项
⊙ InternetQueryDataAvailable 查询可用数据的数量
⊙ InternetReadFile(Ex) 从一个打开的句柄读取数据
⊙ InternetFindNextFile 继续文件搜寻
⊙ InetrnetSetFilePointer 为 InternetReadFile 设置一个文件位置
⊙ InternetWriteFile 将数据写到一个打开的 Internet 文件
⊙ InternetLockRequestFile 允许用户为正在使用的文件加锁
⊙ InternetUnlockRequestFile 解锁被锁定的文件
⊙ InternetTimeFromSystemTime 根据指定的 RFC 格式格式化日期和时间
⊙ InternetTimeToSystemTime 将一个 HTTP 时间/日期字串格式化为 SystemTime 结构对象
⊙ InternetConfirmZoneCrossing 检查在安全 URL 和非安全 URL 间的变化
⊙ InternetCloseHandle 关闭一个单一的 Internet 句柄
⊙ InternetErrorDlg 显示错误信息对话框
⊙ InternetGetLastResponesInfo 获取最近发送的 API函数的错误
2、HTTP 处理函数
⊙ HttpOpenRequest 打开一个 HTTP 请求的句柄
⊙ HttpSendRequert(Ex) 向 HTTP 服务器发送指定的请求
⊙ HttpQueryInfo 查询有关一次 HTTP 请求的信息
⊙ HttpEndRequest 结束一个 HTTP 请求
⊙ HttpAddRequestHeaders 添加一个或多个 HTTP 请求报头到 HTTP请求句柄
3、FTP 处理函数
⊙ FtpCreateDirectory 在 Ftp 服务器新建一个目录
⊙ FtpDelectFile 删除存储在 Ftp 服务器上的文件
⊙ FtpFindFirstFile 查找给定 Ftp 会话中的指定目录
⊙ FtpGetCurrentDirectory 为指定 Ftp 会话获取当前目录
⊙ FtpGetFile 从 Ftp 服务器下载文件
⊙ FtpOpenFile 访问一个远程文件以对其进行读写
⊙ FtpPutFile 向 Ftp 服务器上传文件
⊙ FtpRemoveDirectory 在 Ftp 服务器删除指定的文件
⊙ FtpRenameFile 为 Ftp 服务器上的指定文件改名
⊙ FtpSetCurrentDirectory 更改在 Ftp 服务器上正在使用的目录
WinInet 层关系
1、WinInet 是一个网络编程接口,包含了 Internet 底层协议 HTTP,FTP。
2、借助 WinInet 接口,可不必去了解 Winsock、TCP/IP 和特定 Internet 协议的细节就可以编写出高水平的 Internet 客户端程序。
3、WinInet 为 HTTP、FTP 提供了统一的函数集,也就是 Win32 API 接口。
4、WinInet 简化了 HTTP、FTP 协议的编程,可轻松地将 Internet 集成到应用程序中。
Hinternet 句柄的层次关系
1、首先通过 InternetOpen 函数创建位于根部的 Hinternet 句柄,然后才能通过其进一步建立 HTTP、FTP 的连接。
2、使用 InternetConnect 函数创建一个指定的连接,它将通过传递给它的参数为指定的站点初始化 HTTP、FTP 连接并创建一个从根句柄分支出去的 Hinernet 句柄。
3、HttpOpenRequest 和 FtpOpenFile、FtpFindFirstFile等函数将使用 InternetConnect
所创建的句柄以建立到指定站点的连接。
HTTP 函数层次关系
1、对于 WWW 服务器提供的资源可以直接通过 InternetOpenUrl 或是 HTTP 函数对潜在的协议进行处理来访问。
2、由于 HTTP 协议是在不断发展的,当这些底层协议被更新后也将影响这些 HTTP 函数行为
3、InternetOpen、InternetConnect、HttpOpenRequest 将返回 Hinternet 句柄,而HttpAddRequestHeaders、HttpQueryInfo、HttpSendRequest、HttpSendRequestEx、InternetErrorDlg 将使用它们所依靠的这些函数创建的 Hinternet句柄。
FTP 函数层次关系
1、FTP 函数需要请求得到特定类型的 Hinternet句柄才能正常工作,这些句柄的创建必须按一定次序来进行:
1、首先使用 InternetOpen 创建根句柄,然后才能通过 InternetConnect 创建一个FTP连接句柄
2、该图展示了依赖于 InternetConnect 所返回FTP 连接句柄的 FTP函数之间的层次关系。
典型的 HTTP 客户端程序的处理流程
1、目的:开始 HTTP会话,建立 HTTP 连接
方法:InetrnetOpen、InternetAttemptConnect、InternetConnect
结果:初始化 WinInet.dll 并联接服务器,返回相应的句柄
2、目的:创建一个 HTTP请求
方法:HttpOpenRequest
结果:
3、目的:发送一个 HTTP请示
方法:HttpAddRequestHeaders
HttpSendRequest(Ex)
结果:
4、目的:读文件
方法:InternetReadFile(Ex)
结果:使用你提供的缓冲读指定的字节
5、目的:获取 HTTP请求信息
方法:HttpQueryInfo
结果:从服务器获取 HTTP 请求头信息
6、目的:异常处理
方法:InternetGetLastResponesInfo、InternetErrorDlg
结果:处理所有普通的异常类型
7、目的:结束 HTTP 会话
方法:HttpEndRequest、InternetCloseHandle
结果:自动清除打开的句柄的连接
InetrnetOpen 初始化
InternetOpen(lpszAgent: PChar;
dwAccessType: DWORD;
lpszProxy,
lpszProxyBypass:PChar;
dwFlags: DWORD): HINTERNET; stdcall;
参数:
1、lpszAgent 应用程序名,可以自定义
2、dwAccessType 存取类型,可以是:
①INTERNET_OPEN_TYPE_PRECONFIG =0 使用 IE 中的连接设置
②INTERNET_OPEN_TYPE_DIRECT =1 直接连接到服务器
③INTERNET_OPEN_TYPE_PROXY =3 通过代理服务器进行连接
为 3 时需指定代理服务器地址
3、lpszProxy CERN 代理服务器地址,一般设置为 null;
4、lpszProxyBypass 代理服务器地址;
5、dwFlags 标记,一般设置为 0,可以是:
①INTERNET_FLAG_DONT_CACHE 不在缓存中保存取得的内容
②INTERNET_FLAG_OFFLINE 脱机方式
InternetOpenUrl 打开 Url,读取数据
InternetOpenUrl(hInet: HINTERNET;
lpszUrl: PChar;
lpszHeaders: PChar;
dwHeadersLength: DWORD;
dwFlags: DWORD;
dwContext: DWORD): HINTERNET; stdcall;
2、参数:
1、hInet 由 InternetOpen返回的句柄
2、lpszUrl 文件 Url 地址,以 http:,ftp:打头的 Url 地址;
3、lpszHeaders 发送到服务器的数据头;
4、dwHeadersLength 发送到服务器的数据头长度
5、dwFlags 标记,可以是:
①INTERNET_FLAG_RELOAD 强制重读数据
②INTERNET_FLAG_DONT_CACHE 不保存到缓存
③INTERNET_FLAG_TRANSFER_ASCII 使用文本数据
④INTERNET_FLAG_TRANSFER_BINARY 使用二进制数据
6、dwContext 上下文标记,如果使用回调功能时这个值将传送给回调函数
Internet 的连接
InternetConnect
InternetConnect(hInet: HINTERNET;
lpszServerName: PChar;
nServerPort: INTERNET_PORT;
lpszUsername: PChar;
lpszPassword: PChar;
dwService: DWORD;
dwFlags: DWORD;
dwContext: DWORD): HINTERNET; stdcall;
参数:
1、hInet 由 InternetOpen 返回的句柄
2、lpszServerName 服务器的地址
HTTP 地址必须为服务器名作InternetOpenUrl语法分析
3、nServerPort HTTP协议端口号(缺省80)
4、lpszUsername 用户名
5、lpszPassword 用户密码
6、dwService 决定服务类型 HTTP,FTP,可以是:
①INTERNET_SERVICE_FTP = 1; 连接到一个 FTP 服务器上
②INTERNET_SERVICE_HTTP = 3; 连接到一个 HTTP 服务器上
7、dwFlags
8、dwContext
HttpOpenRequest
HttpOpenRequest(hConnect: HINTERNET;
lpszVerb: PChar;
lpszObjectName: PChar;
lpszVersion: PChar;
lpszReferrer: PChar;
lplpszAcceptTypes: PLPSTR;
dwFlags: DWORD;
dwContext: DWORD): HINTERNET; stdcall;
参数:
1、hConnect InternetConnect句柄
2、lpszVerb 命令字,如果为 NULL,使用缺省值“GET”
3、lpszObjectName 命令对象,通常是一个文件名、可执行文件或是一个搜索列表
4、lpszVersion HTTP版本,如果为空,将使用“HTTP/1.0”
5、lpszReferrer 一个网址,可以为空
6、lplpszAcceptTypes中程序接收的文件类型列表。把空值传给该函数即通知了服务器只有文本文件可以被接收‘application/octet-stream‘
7、dwFlags 标志 使用 or 连接标志
①INTERNET_FLAG_NO_CACHE_WRITE 标志不缓冲写
②INTERNET_FLAG_KEEP_CONNECTION 保持连接
③INTERNET_FLAG_SECURE { use PCT/SSL if applicable (HTTP) }
{ Security Ignore Flags, Allow HttpOpenRequest to overide
Secure Channel (SSL/PCT) failures of the following types. }
④INTERNET_FLAG_IGNORE_CERT_CN_INVALID { bad common name in X509 Cert. }
⑤INTERNET_FLAG_IGNORE_CERT_DATE_INVALID { expired X509 Cert. }
8、dwContext Integer(Self)?
向 HTTP 服务器发送指定的请求
HttpSendRequest
HttpSendRequest(hRequest: HINTERNET;
lpszHeaders: PChar;
dwHeadersLength: DWORD;
lpOptional: Pointer;
dwOptionalLength: DWORD): BOOL; stdcall;
参数:
1、hRequest HttpOpenRequest句柄
2、lpszHeaders 服务请求的数据头
3、dwHeadersLength 服务请求的数据头的长度
4、lpOptional 紧跟在标题后任意数据的地址,此参数一般用于 POST 和 PUT 操作
5、dwOptionalLength 数据的长度
InternetSetOption
InternetSetOption 设置一个 Internet 选项
InternetSetOption(hInet: HINTERNET;
dwOption: DWORD;
lpBuffer: Pointer;
dwBufferLength: DWORD): BOOL; stdcall;
参数:
1、hInet 句柄
2、dwOption Internet 选项,可以是:
①INTERNET_OPTION_SEND_TIMEOUT 设置,发送请求和连接时的超时时间
②INTERNET_OPTION_RECEIVE_TIMEOUT 设置,接收请求和连接时的超时间间
3、lpBuffer 值
4、dwBufferLength 值大小
WinHTTP
https://docs.microsoft.com/en-us/windows/desktop/winhttp/porting-wininet-applications-to-winhttp
Code demo
| Header | winhttp.h |
| Library | Winhttp.lib |
| DLL | Winhttp.dll |
DWORD dwSize = 0;
LPVOID lpOutBuffer = NULL;
BOOL bResults = FALSE;
HINTERNET hSession = NULL,
hConnect = NULL,
hRequest = NULL;
// Use WinHttpOpen to obtain a session handle.
hSession = WinHttpOpen( L"A WinHTTP Example Program/1.0",
WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
WINHTTP_NO_PROXY_NAME,
WINHTTP_NO_PROXY_BYPASS, 0);
// Specify an HTTP server.
if (hSession)
hConnect = WinHttpConnect( hSession, L"www.microsoft.com",
INTERNET_DEFAULT_HTTP_PORT, 0);
// Create an HTTP request handle.
if (hConnect)
hRequest = WinHttpOpenRequest( hConnect, L"GET", NULL,
NULL, WINHTTP_NO_REFERER,
WINHTTP_DEFAULT_ACCEPT_TYPES,
0);
// Send a request.
if (hRequest)
bResults = WinHttpSendRequest( hRequest,
WINHTTP_NO_ADDITIONAL_HEADERS,
0, WINHTTP_NO_REQUEST_DATA, 0,
0, 0);
// End the request.
if (bResults)
bResults = WinHttpReceiveResponse( hRequest, NULL);
// First, use WinHttpQueryHeaders to obtain the size of the buffer.
if (bResults)
{
WinHttpQueryHeaders( hRequest, WINHTTP_QUERY_RAW_HEADERS_CRLF,
WINHTTP_HEADER_NAME_BY_INDEX, NULL,
&dwSize, WINHTTP_NO_HEADER_INDEX);
// Allocate memory for the buffer.
if( GetLastError( ) == ERROR_INSUFFICIENT_BUFFER )
{
lpOutBuffer = new WCHAR[dwSize/sizeof(WCHAR)];
// Now, use WinHttpQueryHeaders to retrieve the header.
bResults = WinHttpQueryHeaders( hRequest,
WINHTTP_QUERY_RAW_HEADERS_CRLF,
WINHTTP_HEADER_NAME_BY_INDEX,
lpOutBuffer, &dwSize,
WINHTTP_NO_HEADER_INDEX);
}
}
// Print the header contents.
if (bResults)
printf("Header contents: \n%S",lpOutBuffer);
// Free the allocated memory.
delete [] lpOutBuffer;
// Report any errors.
if (!bResults)
printf("Error %d has occurred.\n",GetLastError());
// Close any open handles.
if (hRequest) WinHttpCloseHandle(hRequest);
if (hConnect) WinHttpCloseHandle(hConnect);
if (hSession) WinHttpCloseHandle(hSession);
WinHttpQueryDataAvailable\WinHttpReadData
DWORD dwSize = 0;
DWORD dwDownloaded = 0;
LPSTR pszOutBuffer;
BOOL bResults = FALSE;
HINTERNET hSession = NULL,
hConnect = NULL,
hRequest = NULL;
// Use WinHttpOpen to obtain a session handle.
hSession = WinHttpOpen( L"WinHTTP Example/1.0",
WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
WINHTTP_NO_PROXY_NAME,
WINHTTP_NO_PROXY_BYPASS, 0);
// Specify an HTTP server.
if (hSession)
hConnect = WinHttpConnect( hSession, L"www.microsoft.com",
INTERNET_DEFAULT_HTTPS_PORT, 0);
// Create an HTTP request handle.
if (hConnect)
hRequest = WinHttpOpenRequest( hConnect, L"GET", NULL,
NULL, WINHTTP_NO_REFERER,
WINHTTP_DEFAULT_ACCEPT_TYPES,
WINHTTP_FLAG_SECURE);
// Send a request.
if (hRequest)
bResults = WinHttpSendRequest( hRequest,
WINHTTP_NO_ADDITIONAL_HEADERS,
0, WINHTTP_NO_REQUEST_DATA, 0,
0, 0);
// End the request.
if (bResults)
bResults = WinHttpReceiveResponse( hRequest, NULL);
// Continue to verify data until there is nothing left.
if (bResults)
do
{
// Verify available data.
dwSize = 0;
if (!WinHttpQueryDataAvailable( hRequest, &dwSize))
printf( "Error %u in WinHttpQueryDataAvailable.\n",
GetLastError());
// Allocate space for the buffer.
pszOutBuffer = new char[dwSize+1];
if (!pszOutBuffer)
{
printf("Out of memory\n");
dwSize=0;
}
else
{
// Read the Data.
ZeroMemory(pszOutBuffer, dwSize+1);
if (!WinHttpReadData( hRequest, (LPVOID)pszOutBuffer,
dwSize, &dwDownloaded))
printf( "Error %u in WinHttpReadData.\n", GetLastError());
else
printf( "%s\n", pszOutBuffer);
// Free the memory allocated to the buffer.
delete [] pszOutBuffer;
}
} while (dwSize > 0);
// Report any errors.
if (!bResults)
printf( "Error %d has occurred.\n", GetLastError());
// Close open handles.
if (hRequest) WinHttpCloseHandle(hRequest);
if (hConnect) WinHttpCloseHandle(hConnect);
if (hSession) WinHttpCloseHandle(hSession);