Функция HttpAddRequestHeadersA (wininet.h)
Добавляет один или несколько заголовков HTTP-запроса в дескриптор HTTP-запроса.
Синтаксис
BOOL HttpAddRequestHeadersA(
[in] HINTERNET hRequest,
[in] LPCSTR lpszHeaders,
[in] DWORD dwHeadersLength,
[in] DWORD dwModifiers
);
Параметры
[in] hRequest
Дескриптор, возвращаемый вызовом функции HttpOpenRequest .
[in] lpszHeaders
Указатель на строковую переменную, содержащую заголовки для добавления в запрос. Каждый заголовок должен быть завершен парой CR/LF (возврат каретки и поток строки).
[in] dwHeadersLength
Размер lpszHeaders в TCHAR. Если этот параметр имеет значение -1L, функция предполагает, что lpszHeaders завершается с нуля (ASCIIZ), а длина вычисляется.
[in] dwModifiers
Набор модификаторов, управляющих семантикой этой функции. Этот параметр может быть сочетанием следующих значений.
Возвращаемое значение
Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
HttpAddRequestHeaders добавляет дополнительные заголовки в свободном формате к дескриптору HTTP-запроса и предназначен для использования сложными клиентами, которым требуется подробный контроль над точным запросом, отправленным на HTTP-сервер.
Обратите внимание, что для базовых httpAddRequestHeaders приложение может передавать несколько заголовков в одном буфере. Если приложение пытается удалить или заменить заголовок, в lpszHeaders можно указать только один заголовок.
Примечание
Заголовок wininet.h определяет HttpAddRequestHeaders как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | wininet.h |
Библиотека | Wininet.lib |
DLL | Wininet.dll |