HttpQueryInfoA 函数 (wininet.h)
检索与 HTTP 请求关联的标头信息。
语法
BOOL HttpQueryInfoA(
[in] HINTERNET hRequest,
[in] DWORD dwInfoLevel,
[in, out] LPVOID lpBuffer,
[in, out] LPDWORD lpdwBufferLength,
[in, out] LPDWORD lpdwIndex
);
参数
[in] hRequest
调用 HttpOpenRequest 或 InternetOpenUrl 函数返回的句柄。
[in] dwInfoLevel
要检索的属性和修改请求的标志的组合。 有关可能的属性和修饰符值的列表,请参阅 查询信息标志。
[in, out] lpBuffer
指向缓冲区的指针,用于接收请求的信息。 此参数不得 NULL。
[in, out] lpdwBufferLength
指向一个变量的指针,其中包含 lpvBuffer指向的缓冲区的大小(以字节为单位)。
当函数成功返回时,此变量包含写入缓冲区的信息字节数。 对于字符串,字节计数不包括字符串的终止 null 字符。
函数何时
失败并显示 ERROR_INSUFFICIENT_BUFFER的扩展错误代码,lpdwBufferLength 所指向的变量包含的缓冲区的大小(以字节为单位)的大小,足以接收请求的信息。 然后,调用应用程序可以分配此大小的缓冲区或更大的缓冲区,然后再次调用该函数。
[in, out] lpdwIndex
指向从零开始的标头索引的指针,用于枚举具有相同名称的多个标头。 调用函数时,此参数是要返回的指定标头的索引。 函数返回时,此参数是下一个标头的索引。 如果找不到下一个索引,则返回 ERROR_HTTP_HEADER_NOT_FOUND。
返回值
如果成功,则返回 TRUE;否则返回 FALSE。 若要获取扩展的错误信息,请调用 GetLastError。
言论
可以从 HttpQueryInfo检索以下类型的数据:
- 字符串 (默认值)
- SYSTEMTIME(日期)
- DWORD(对于 STATUS_CODE、CONTENT_LENGTH等,如果使用 HTTP_QUERY_FLAG_NUMBER)
如果应用程序要求将数据作为字符串以外的数据类型返回,则必须将相应的修饰符包含在传递给 dwInfoLevel的属性。
HttpQueryInfo 函数适用于 ISO-8859-1 字符的 Microsoft Internet Explorer 3.0(HttpQueryInfoA 函数)和 Internet Explorer 4 对于 ISO-8859-1 字符(HttpQueryInfoA 函数),以及转换为 UTF-16LE 字符的 ISO-8859-1 字符,为 .0 或更高版本。(HttpQueryInfoW 函数)。
与 WinINet API 的其他所有方面一样,不能从 DllMain 或全局对象的构造函数和析构函数中安全地调用此函数。
注意
wininet.h 标头将 HttpQueryInfo 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
支持的最低服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | 窗户 |
标头 | wininet.h |
库 | Wininet.lib |
DLL | Wininet.dll |