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 (
  • 如果已使用HTTP_QUERY_FLAG_NUMBER，则STATUS_CODE、CONTENT_LENGTH等的 DWORD ()

如果应用程序要求将数据作为字符串以外的数据类型返回，则必须使用传递给 dwInfoLevel 的属性包括相应的修饰符。

HttpQueryInfo 函数在 Microsoft Internet Explorer 3.0 中可用于 ISO-8859-1 字符 (HttpQueryInfoA 函数) ，在 Internet Explorer 4.0 或更高版本中适用于 ISO-885 (HttpQueryInfoA 函数) 9-1 个字符，对于转换为 UTF-16LE 字符的 ISO-8859-1 字符， (HttpQueryInfoW 函数) 。

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

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

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

注意

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

要求

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

另请参阅

HTTP 会话

检索 HTTP 标头

WinINet 函数