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

Статья
11/20/2024

Отправляет указанный запрос на 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 и Функции WideCharToMultiBy te с параметром Codepage , равным 28591, для сопоставления между символами ANSI и символами UTF-16LE.

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wininet.h
библиотеки	Wininet.lib
DLL	Wininet.dll

См. также

сеансы HTTP

функций WinINet

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