Функция HttpSendRequestExA (wininet.h)

Статья
08/27/2023

Отправляет указанный запрос на 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. В результате функция HttpSendRequestExW никогда не является безопасной, если добавляемые заголовки могут содержать символы, отличные от ASCII. Вместо этого приложение может использовать функции MultiByteToWideChar и WideCharToMultiByte с параметром Codepage , равным 28591, для сопоставления между символами ANSI и символами UTF-16LE.

Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для серверных реализаций или служб используйте службы Microsoft Windows HTTP (WinHTTP).

Примечание

Заголовок wininet.h определяет HttpSendRequestEx в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wininet.h
Библиотека	Wininet.lib
DLL	Wininet.dll

См. также раздел

Сеансы HTTP

Функции WinINet

Поделиться через