httpSendRequestExA 函数 (wininet.h)

  • 项目

将指定的请求发送到 HTTP 服务器。

注意 需要发送超出通常传递到 HttpSendRequestEx 的额外数据的调用方可以通过调用 HttpSendRequest 来执行此操作。
 

语法

BOOL HttpSendRequestExA(
  [in]  HINTERNET           hRequest,
  [in]  LPINTERNET_BUFFERSA lpBuffersIn,
  [out] LPINTERNET_BUFFERSA lpBuffersOut,
  [in]  DWORD               dwFlags,
  [in]  DWORD_PTR           dwContext
);

参数

[in] hRequest

调用 HttpOpenRequest 函数返回的句柄。

[in] lpBuffersIn

可选。 指向 INTERNET_BUFFERS 结构的指针。

[out] lpBuffersOut

保留。 必须为 NULL。

[in] dwFlags

保留。 必须为零。

[in] dwContext

应用程序定义的上下文值（如果已注册状态回调函数）。

返回值

如果该函数成功，则函数返回 TRUE。

如果函数失败，则返回 FALSE。 要获得更多的错误信息，请调用 GetLastError。

注解

HttpSendRequestEx 执行响应的发送和接收。 这不允许应用程序发送传递到 HttpSendRequestEx 的单个缓冲区以外的任何额外数据。 需要发送超出通常传递到 HttpSendRequestEx 的额外数据的调用方可以通过调用 HttpSendRequest 来执行此操作。 调用 HttpSendRequestEx 后，通过调用 InternetWriteFile 发送剩余数据。 最后，请继续调用 HttpEndRequest。

注意HttpSendRequestExA 函数表示要以 ISO-8859-1 字符而不是 ANSI 字符的形式发送的数据。 HttpSendRequestExW 函数表示要以 ISO-8859-1 字符的形式发送的数据，这些字符转换为 UTF-16LE 字符。 因此，当要添加的标头可能包含非 ASCII 字符时，使用 HttpSendRequestExW 函数永远不会安全。 相反，应用程序可以使用 MultiByteToWideChar 和 WideCharToMultiByte 函数，并将 Codepage 参数设置为 28591，以在 ANSI 字符和 UTF-16LE 字符之间映射。
 
注意 WinINet 不支持服务器实现。 此外，不应从服务使用它。 对于服务器实现或服务，请使用 Microsoft Windows HTTP Services (WinHTTP) 。
 

注意

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

要求

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

另请参阅

HTTP 会话

WinINet 函数