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

调用 HttpOpenRequestInternetOpenUrl 函数返回的句柄。

[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_CODECONTENT_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 函数)。

注释HttpQueryInfoA 函数将标头表示为 ISO-8859-1 字符,而不是 ANSI 字符。 HttpQueryInfoW 函数将标头表示为转换为 UTF-16LE 字符的 ISO-8859-1 字符。 因此,当标头可以包含非 ASCII 字符时,使用 HttpQueryInfoW 函数是不安全的。 相反,应用程序可以使用 MultiByteToWideCharWideCharToMultiByte 函数,并将 Codepage 参数设置为 28591,以在 ANSI 字符和 UTF-16LE 字符之间映射。
 
有关调用 HttpQueryInfo 函数的示例代码,请参阅 检索 HTTP 标头

与 WinINet API 的其他所有方面一样,不能从 DllMain 或全局对象的构造函数和析构函数中安全地调用此函数。

注意 WinINet 不支持服务器实现。 此外,不应从服务使用它。 对于服务器实现或服务,请使用 Microsoft Windows HTTP 服务(WinHTTP)
 

注意

wininet.h 标头将 HttpQueryInfo 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 wininet.h
Wininet.lib
DLL Wininet.dll

另请参阅

HTTP 会话

检索 HTTP 标头

WinINet 函数